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Chapter 1 


ОМЕТ Connection Manager 
Framework API 


1.1 References 


[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 


1.2 Overview 


This document describes the Framework API for the Connection Manager (CM) component of the LiMo 
Data Networking framework. This document also includes sample call flows (MSCs) for Connection Man- 
ager interface Call Flow Diagrams. The call flows have been provided to get a better understanding of 
Connection Manager API’s and use cases. 


1.3 Industry Standard 


None 


1.4 External API Documents 


None 


1.5 Plug-in Extension Point Interface 


None 


1.6 Other Interfaces 


None 


2 DNET Connection Manager Framework АРІ 


1.7 Other Notes 


See Call Flow Diagrams for more information. 
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Chapter 2 


Module Index 


2.1 Modules 


Here is a list of all modules: 


Connection Manager... 2... p e неее p 11 
Protile Manager чәе жей! зр. ecu oe КАГДЫ ЛЕ КЫ ОЗН р ет Vb EE жері 29 
PDP Transport Interfaces къ эу ык жез езй илк ее m OR ЫСЫ ee з 34 


WLAN Transport Interface ..................................... 42 


Module Index 
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Chapter 3 


Data Structure Index 


31 Data Structures 


Here are the data structures with brief descriptions: 


IpAdde $ (IP Address ) wc o ео рю ооо Re И И ee а 
NetAddr_t (Network Address information) ............................ 
NetAuthInfo_t (PDP Authentication ШЇїогтайоп)......................... 
NetBssInfo t (BSS Шїюптайоп).................................. 
NetCMTunnelInfo t (Tunnel data: Used in sending tunnel request to Connection Manager). . . 
NetDevInfo t (Device Info іп Соппесїтеёвропзееуеешнш)...................... 
NetEventInfo t (Event Info with Event on callback from Connection Manager) ......... 
NetEventTunnelIndInfo_t (Event Info with Event on Indication from Connection Manager). . . 
NetPdpConnectRspEvInfo (Connect Response event data) .................... 
NetPDPConnectRspInfo_t (Connect Response event data) .................... 
NetPdpConnInfo_t (Transport Error Сайзе)............................ 
NetPdpDisConnectIndEvInfo (Connect Close Indication event data) ............... 
NetPdpDisConnectRspEvInfo (Connect Close Response event data) ............... 
NetPdpEventInfo t (PDP Transport Event Шю).......................... 
NetPdpProfileInfo t (PDP Profile Profile Information) ...................... 
NetPdpQosGprs_t (PDP GPRS Qos Шїюгтайпоп)......................... 
NetPdpQosInfo_t (PDP Qos шШЇїогтайоп)............................. 
NetPdpQosUmts_t (PDP UMTS(3G) Qos шШЇїюгтайоп)...................... 
NetPdpResumeIndEvInfo (Connect Resume Indication event айа)................ 
NetPdpSuspendIndEvInfo (Connect Suspend Indication event data) ............... 
NetPdpTransportEventInfo_t (Connection Event Info) ...................... 
NetPdpTunnelEvInfo (Tunnel Response Event Info) ....................... 
NetProfile t (Profile data structures: Used between CM and PM Plug-in Interface) ....... 
NetWlanConnectRspEvInfo (Connect Response event data ) ................... 
NetWlanConnectRspInfo t (Connect Response event 4айда).................... 
NetWlanConnInfo_t (Transport Error Cause) ........................... 
NetWlanDisConnectIndEvInfo (Connect Close Indication event data) .............. 
NetWlanDisConnectRspEvInfo (Connect Close Response event data) .............. 
NetWlanEventInfo_t (WLAN Transport Event Info). ....................... 
NetWlanProfileInfo t (WLAN Profile Profile Ішіогпайоп).................... 
NetWlanTransportEventInfo t (Connection Event ШЇїо)...................... 
NetWlanTunnelEvInfo (Tunnel Response Event Іпо)....................... 
ProfileInfo t (Profile information : Union of PDP and WLAN profile information) ....... 


Data Structure Index 


Qos t (Union of different type ОЁОо$шо)............................ 89 
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Chapter 4 


File Index 


4. File List 


Here is a list of all documented files with brief descriptions: 


ComponentOverview.h (Component Programming Interface Overview Header Template for 

Doxygen) 4 $8 6a Fav Gekko eee be whee SHS E mot RUE ЖАСА 
NetCMConfig.h (This file describes vendor specific configurable constants of CM Module). . . 
NetCMError.h (This file defines the common етогсойе@е)..................... 
NetCMIntf.h (This file defines the interface of Connection Manager with the application)... . 
NetCMTransportIntf.h (Interface File describing CM Constants) ................. 
PMIntf-h (This file defines the interface of Profile Manager with the application/Connection Man- 

арег) зоо т ооо 
Transport3GIntf.h (PDP Transport Interface) ........................... 
TransportWlanIntf.h (WLAN Transport Interface) ........................ 


File Index 
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Chapter 5 


Page Index 


5.1 Related Pages 


Here is a list of all related documentation pages: 


10 


Page Index 
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Chapter 6 


Module Documentation 


6.1 Connection Manager 


Files 


file NetCMConfig.h 


This file describes vendor specific configurable constants of CM Module. 


file NetCMError.h 


This file defines the common error code. 


file NetCMIntf.h 


This file defines the interface of Connection Manager with the application. 


file NetCMTransportIntf.h 


Interface File describing CM Constants. 


Data Structures 


* struct NetEventInfo t 


Event Info with Event on callback from Connection Manager. 


* struct NetEventTunnelIndInfo t 


Event Info with Event on Indication from Connection Manager. 


* struct NetDevInfo t 


Device Info in Connect response event. 


* struct NetCMTunnelInfo t 


Tunnel data: Used in sending tunnel request to Connection Manager. 
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Defines 


* #define NET CONNECTIONS MAX NET CONNECTIONS MAX VENDOR DEFINED 


Maximum Number of Connections that can be established simultaneously-It is Vendor specific value. 


* #define NET DEVICE МАМЕ LEN МАХ МЕТ DEVICE NAME LEN MAX VENDOR - 
DEFINED 


Maximum length of device name that will be created after a successful connection establishment-It is Vendor 
specific value. 


* #define NET DNS ADDR. MAX NET DNS ADDR МАХ VENDOR DEFINED 
MAX number of DNS Address-It is Vendor specific value. 


* #define NET СМ FAILURE -1 
Value of Constant FAILURE. 


* #define NET CM, SUCCESS 0 
Value of Constant SUCCESS. 


* #define NET СМ INVALID ID -1 
Invalid Request ID. 


Typedefs 


e typedef void(« NetAppEvtCb t )(const NetEventInfo t «NetEvent) 


callback function: used to notify client application about Asynchronous events. 


Enumerations 


e enum NetErr t ( 


NET ERR NONE = 0x00, NET ERR UNKNOWN , NET ERR APP ALREADY - 
REGISTERED, NET ERR. APP REGISTRATION FAILED, 


NET ERR APP MAX CLIENT REGISTERED, NET ERR INVALID CLIENT, NET ERR - 
INVALID PROFILEID, NET ERR. NO ACTIVE CONNECTIONS, 


NET ERR ACTIVE CONNECTION EXISTS, NET ERR. CONNECTION KILLING, NET - 
ERR. CONNECTION OPENING, NET ERR. CONNECTION CLOSING, 


NET ERR МАХ CONNECTIONS, NET ERR MAX CLIENTS PER CONNECTION, NET - 
ERR MAX CONNECTION KILL REQ, NET ERR MAX TUNNEL REQ, 


NET ERR ACCESS DENIED, NET ERR INVALID PARAM, NET ERR INVALID - 
OPERATION, NET ERR. TRANSPORT, 


NET ERR. CONNECTION KILLED } 


Error Defination. 


enum NetEvent t { 


NET EVENT OPEN RSP, NET EVENT CLOSE RSP, NET EVENT KILL RSP, NET - 
EVENT CLOSE IND, 
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NET EVENT SUSPEND IND, NET EVENT RESUME IND, NET EVENT TUNNEL RSP, 
NET EVENT TUNNEL IND } 


Callback Event. 


enum NetTransportIype t { NET. TRANSPORT. TYPE РОР, NET TRANSPORT TYPE - 
WLAN ] 


Transport Type. 


Functions 


int NetCMClientRegister (NetAppEvtCb t EventCb) 


This API shall register the client application with the CM server. 


int NetCMClientDeRegister () 


This API will deregister the client application with the CM server. 


int NetCMConnectionOpen (int ProfileId[ ], int ProfileCount) 


This API will establish a data connection for the first entry in the array Profileld. 


int NetCMConnectionClose (int ProfileId) 


This API will terminate the connection referred by the Profileld. 


int NetCMDeviceGetInfo (int ProfileId, NetDevInfo_t *DevInfo) 


This API shall get the device information associated with the connection referred by the Profileld. 


int NetCMGetActiveProfileIDs (int ProfileId[ |, int «ProfileCount) 
This API will retrieve all active profile IDs. 


int NetCMGetTransportError (int *Error) 


This API returns transport specific error cause for the synchronous return of the last initiated API request. 


int NetCMConnectionKill (int ProfileId) 
This API shall kill active connection referred by the Profileld. 


int NetCMTunnelRequest (NetCM TunnelInfo t «TunnelData) 


This API will be used to send any transport specific proprietary information to transport plug-in. 


6.1.1 Define Documentation 


6.1.1.1 define NET CM FAILURE -1 


Value of Constant FAILURE. 


6.1.1.2 ffdefine NET CM INVALID ID -1 


Invalid Request ID. 
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6.1.1.3 fdefine NET СМ SUCCESS 0 


Value of Constant SUCCESS. 


6.1.1.4 define NET CONNECTIONS MAX NET CONNECTIONS MAX VENDOR - 
DEFINED 


Maximum Number of Connections that can be established simultaneously-It is Vendor specific value. 


6.1.1.5 define NET DEVICE МАМЕ LEN МАХ NET DEVICE NAME LEN MAX - 
VENDOR DEFINED 


Maximum length of device name that will be created after a successful connection establishment-It is 
Vendor specific value. 


6.1.1.6 define NET DNS ADDR MAX NET DNS ADDR MAX VENDOR DEFINED 


MAX number of DNS Address-It is Vendor specific value. 


6.1.2 Typedef Documentation 
6.1.2.1 typedef void(« NetAppEvtCb t)(const NetEventInfo t «NetEvent) 


callback function: used to notify client application about Asynchronous events. 


This callback function will be called in the CM Client library context.It should not call any of the CM 
foundation APIs. 


Note: 


CM will allocate the memory for event data. Once Context will return from callback then CM will 
free the memory allocated to event data. Application is not supposed to free the memory pointed by 
NetEvent 


6.1.3 Enumeration Type Documentation 
6.1.31 enum NetErr t 


Error Defination. 


Enumerator: 


NET ERR NONE Хо error. 

NET ERR UNKNOWN Error unknown. 

NET ERR APP ALREADY REGISTERED Application is already registered with the CM. 
NET ERR APP REGISTRATION FAILED Application could not register with CM. 


NET ERR APP MAX CLIENT REGISTERED  Reached the maximum number of clients regis- 
tered. 


NET ERR INVALID CLIENT Client is invalid - It may be unregistered. 
NET ERR INVALID PROFILEID Profile does not exist for the given ProfileId. 
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NET ERR NO ACTIVE CONNECTIONS No active connection exists for the given client or pro- 
file ID. 


NET ERR ACTIVE CONNECTION EXISTS Active connection already exists for the given pro- 
file ID. 


NET ERR CONNECTION KILLING Connection is getting killed. 

NET ERR CONNECTION OPENING  Connention is in connecting state;. 

NET ERR CONNECTION CLOSING  Connention is in disconnecting state;. 
NET ERR MAX CONNECTIONS Reached the maximum number of connections. 


NET ERR MAX CLIENTS PER CONNECTION Maximum Client for a given active connec- 
tion. 


NET ERR MAX CONNECTION КПІ REQ Connection Kill request is failed as maximum kill 
request is pending. 


NET ERR MAX TUNNEL REQ Maximum Tunnel Request is being processed by CM. 
NET ERR ACCESS DENIED Access is denied. 

NET ERR INVALID PARAM Invalid value of API parameter. 

NET ERR INVALID OPERATION invalid operation depending on current state 

NET ERR TRANSPORT Transport specific error. 

NET ERR CONNECTION KILLED Connection killed by other privileged application. 


6.1.3.2 enum NetEvent t 
Callback Event. 


Enumerator: 


NET EVENT OPEN RSP Open Connection Response Event 
Response event for NetCMConnectionOpen to notify the status of open connection request 
Detail of Event Info in Open Response Event (NetEventInfo t):- 
Event: Its value will be NET EVENT OPEN RSP 
ProfileId: ID for which connection has been activated 


Error: Its value will be NET ERR. NONE in case of success and error cause in case of failure 


If its valueis NET ERR. TRANSPORT, application can retrieve the transport specific error using 


Data field (Data will be of type Int in this case) 
Data: In case of success, it will point to data of type NetDevInfo t 


If the error value is NET ERR, TRANSPORT, it will point to transport specific error (Data will 


be of type Int in this case). 


NET EVENT CLOSE RSP Close Connection Response Event 
Response event for NetConnectionClose to notify the status of close connection request 


Detail of Event Info in Close Response Event (NetEventInfo t):- 
Event: Its value will be NET EVENT CLOSE RSP 
ProfileId: Profile ID for which Close Connection was requested 


Error: Its value will be NET ERR. NONE in case of success and error cause in case of failure 


If its valueis NET ERR. TRANSPORT, application can retrieve the transport specific error using 


Data field (Data will be of type Int in this case) 


Data: In case of success, it will be NULL, If the error value is NET ERR. TRANSPORT, it will 


point to transport specific error (Data will be of type Int in this case). 
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NET EVENT KILL RSP Kill Connection Response Event 
Response event for NetCMConnectionKill to notify the status of kill connection request 
Detail of Event Info in Kill Response Event (NetEventInfo 1):- 
Event: Its value will be NET EVENT КПІ, RSP 
ProfileId: Profile ID of the connection for which Kill Connection was requested 
Error: Its value will be NET ERR. NONE in case of success and error cause in case of failure 
If its valueis NET ERR. TRANSPORT, application can retrieve the transport specific error using 
Data field (Data will be of type Int in this case) 
Data: In case of success, it will be NULL, If the error value is NET ERR. TRANSPORT, it will 
point to transport specific error (Data will be of type Int in this case). 

NET EVENT CLOSE IND Connection Close Indication Event 
Indication to notify the closure of an active connection due to network initiated termination or 
any other transport connectivity loss. 


Detail of Event Info in close Indication Event (NetEventInfo  t):- 
Event: Its value will be NET EVENT CLOSE IND 
ProfilelId: Profile ID for which the connection got disconnected 


Error: Its value will be NET ERR. NONE in case of success and error cause in case of failure 
If its valueis NET ERR. TRANSPORT, application can retrieve the transport specific error using 
Data field (Data will be of type Int in this case) 
Data: In case of success, it will be NULL, If the error value is NET ERR. TRANSPORT, it will 
point to transport specific error (Data will be of type Int in this case). 

NET EVENT SUSPEND IND Connection Suspend Indication Event 
Indication to notify that data transfer in a connection is suspended 
Detail of Event Info in Suspend Indication Event (NetEventInfo t) :- 
Event: Its value will be NET EVENT SUSPEND IND 
ProfileId: Profile ID of the connection for which the data transfer is suspended 


Error: It will be the reason for data suspension.If its value is NET ERR. TRANSPORT, applica- 
tion can retrieve transport specific cause using Data field(Data will be of type Int in this case) 


Data: If the Error value is NET ERR. TRANSPORT, it will point to transport specific error (Data 
will be of type Int in this case). 
NET EVENT RESUME IND Connection Resume Indication Event 
Indication to notify that data transfer in a connection has resumed 
Detail of Event Info in Resume Indication Event (NetEventInfo_t):- 
Event: Its value will be NET EVENT RESUME IND 
ProfileId: Profile ID of the connection for which the data transfer has resumed 
Error: It will be the reason for resumption of data transfer 
If its value is NET ERR. TRANSPORT, application can retrieve transport specific cause using 
Data field(Data will be of type Int in this case) 
Data: If the Error value 15 NET ERR, TRANSPORT, it will point to transport specific error (Data 
will be of type Int in this case). 
NET EVENT TUNNEL RSP Tunnel Response Event 
Response event for NetCMTunnelRequest to notify the status of Tunnel request. 
Detail of Event Info in Tunnel Response Event (NetEventInfo, t):- 
Event: Its value will be NET EVENT TUNNEL RSP 
ProfileId: Its value is irrelevant 
Error: its value will be irrelevant 


Data: This will point to data of type: NetCM TunnellInfo t, Application and transport plug-in can 
use this to communicate any data CM is unaware of any information regarding this data. 
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NET EVENT TUNNEL IND Tunnel Indication Event 
Indication to notify any transport specific Tunnel event (other than response events) from trans- 
port plug-in 
Tunnel Indication is sent from Connection manager server to registered application via Event 
Delivery.Actual Event Delivery Name for this event is Networking.Connection.TunnelInd. 


Structure associated with Tunnel Indication: NetEventTunnelIndInfo t 
Event: Its value will be NET EVENT TUNNEL IND 
TransportType: Transport type of Tunnel Indication 

Len: length of the data buffer 

Data: Event Data Buffer. 

Note: 


Client application receives this event from ED in Base64 encoded format. Application needs 
to decode the event data and typecast the event data into data type: NetEventTunnelIndInfo t 


6.1.33 enum NetTransportType t 


Transport Type. 


Enumerator: 
NET TRANSPORT TYPE PDP PDP Transport type. 
NET TRANSPORT TYPE WLAN WLAN Transport type. 


6.1.4 Function Documentation 
6.1.41 int NetCMClientDeRegister () 
This API will deregister the client application with the CM server. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


After deregistration, Application will be restricted from using other CM APIs/Services. 
De-register is not allowed when any connection is in active or transition state (connection kill, activa- 
tion or deactivation in progress). 


Warning: 
None 


Async Response Message: 


None 


Precondition: 


Application must already be registered with the CM server. 
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Returns: 


Return Type (int) 


NET ERR NONE - indicating that the operation has completed successfully. 


NET ERR INVALID CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 


NET ERR, ACTIVE CONNECTION EXISTS -indicating that an active connection is associ- 
ated with the client and deregistration is not possible. 


NET ERR, CONNECTION OPENING -indicating that a connection associated with the client 
is opening and deregistration is not possible. 


МЕТ ERR, CONNECTION. CLOSING -indicating that a connection associated with the client 
is closing and deregistration is not possible. 


NET ERR, CONNECTION. KILLING - indicating that a connection associated with the client 
is being killed or client is killing some connection.Deregistration is unsuccessful. 


NET ERR, UNKNOWN -indicating that an unknown error has occured. 


Prospective Clients: 


External Apps. 


Example Program: 


int result; 
result = NetCMClientDeRegister ( ); 
if(result == NET ERR, NONE)......... 


6.1.42 int NetCMClientRegister (NetAppEvtCb t EventCb) 
This API shall register the client application with the CM server. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


It is mandatory for the client application to register with CM server with this API before using any of 
its services. 

The value of EventCb cannot be NULL. Otherwise, error NET ЕКЕ INVALID PARAM will be re- 
turned by the API. 

АП the Asynchronous Events from CM server will be sent to the client App through the callback 
function (EventCb) registered with this API. 


Warning: 
None 


Parameters: 


EventCb [IN] Application callback to receive CM events. 
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Async Response Message: 
None. 

Precondition: 
None. 


Returns: 


Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 
* NET ERR INVALID PARAM - indicating that API parameter value is invalid. 


e NET ERR APP ALREADY REGISTERED - indicating that client application is already regis- 
tered,it can not be registered again. 


* NET ERR. APP MAX CLIENT REGISTERED - indicating that maximum number of clients 
have already been registered . 


e NET ERR. APP REGISTRATION FAILED - indicating that registration has failed. 


Prospective Clients: 


External Apps. 


Example Program: 


int result; 
result = NetCMClientRegister( CallBack ); 
if(result == NET_ERR_NONE.)......... 


6.1.4.3 int NetCMConnectionClose (int ProfileId) 


This API will terminate the connection referred by the Profileld. 


This API can also be used to abort a connection in progress. 


Sync (or) Async: 


This is a Asynchronous API. 


Important Notes: 


This API is an asynchronous API .Return value only implies whether the request is sent successfully 
or not. Return value Success doesn't imply that the connection is disconnected successfully. 

This API will close the physical link for the connection (referred by the profile ID) only if itis the only 
client using the connection. 

For every connection established with the NetCMConnectionOpen API, client Application should dis- 
connect the connection with this API whenever it doesn't require the connection. 

This API can also be used to abort a connection in progress, before receiving the NET EVENT - 
ОРЕМ КР response event 

A positive integer is a valid value for the Profile ID. 
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Warning: 


None 


Notes : 


CM requests transport to close the connection only if there are no other applications using the active 
connections associated with the profile ID 


Parameters: 


Profileld |IN] Profile Identifier 


Async Response Message: 


NET EVENT CLOSE RSP: Connection Close response will be sent asynchronously to the App in 
the callback function registered as NET EVENT CLOSE RSP event. 


Precondition: 


Application must have a active data connection associated with the ProfileId 


Returns: 
Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 

* NET ERR INVALID CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 

* NET ERR INVALID PROFILEID -indicating that profile ID parameter passed in the API is 


invalid. 


e NET ERR. NO ACTIVE CONNECTIONS -indicating that there is no active connection asso- 
ciated with the client for the requested profile ID. 


e NET ERR CONNECTION KILLING -indicating that client has already requested for killing 
the connection(referred by the parameter profilelId). 


e NET ERR. CONNECTION CLOSING -indicating that client has already requested for closing 
the connection(referred by the parameter profilelId). 


e NET ERR. UNKNOWN -indicating that an unknown error has occured. 


Prospective Clients: 


External Apps. 


Example Program: 


int result; 
result = NetCMConnectionClose( Profileld ); 
if(result == NET ERR, NONE)......... 
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6.1.4.4 int NetCMConnectionKill (int ProfileId) 


This API shall kill active connection referred by the Profileld. 


Kill request will bring the physical link down for the connection referred by the profile ID. 


Sync (or) Async: 
This is a ASynchronous API. 


Important Notes: 


API is a asynchronous API. Return value only implies whether the request is sent successfully or not. 
Return value Success does not imply that the connection is killed successfully. 

Once Connection has been successfully killed, then event NET EVENT CLOSE IND will send to 
application which has opened the connection and event NET EVENT KILL  RSP to the application 
calling this API. 

NET EVENT KILL RSP will be sent to application calling this API even if the same application has 
opened the connection. 

A positive integer is a valid value for the Profile ID. 


Warning: 


API must be called from privileged application only. 


Parameters: 


Profileld |IN] Profile Identifier 


Async Response Message: 
Connection Kill response will be sent asynchronously to the App in the callback function registered as 
NET EVENT KILL RSP event. 

Precondition: 
Application must already be registered with the CM server. API must be called from privileged appli- 
cation only. 

Returns: 


Return Type (int) 


NET ERR NONE - indicating that the operation has completed successfully. 

NET ERR INVALID CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 

МЕТ ERR, CONNECTION. KILLING - indicating that the connection is already being killed 
by the same client. 

NET ЕКЕ MAX CONNECTION KILL КЕО -indicating that maximum number of kill re- 
quests are already being processed by CM 

NET ERR INVALID PROFILEID -indicating that profile ID parameter passed in the API is 
invalid. 


NET ERR, UNKNOWN -indicating that an unknown error has occured. 


Prospective Clients: 


External Apps. 
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Example Program: 


int result; 

int Profileld; 

result = NetCMConnectionKill( ProfileId ); 
if(result == NET ERR, NONE).......... 


6.1.4.5 int NetCMConnectionOpen (int ProfileId| ], int ProfileCount) 
This API will establish a data connection for the first entry in the array Profileld. 


Sync (or) Async: 


This is a Asynchronous API. 


Important Notes: 


This API is a Non-Blocking API.Return value only implies whether the request is sent successfully or 
not. Return value Success does not imply that the connection is established successfully. 

If client Application requires multiple connections, it can call this API multiple times. 

If Application calls this API for multiple times, NET EVENT OPEN RSP will be sent multiple times, 
once for each connection request. 

If the ProfileId is 0, default profile will be used in connection. CM will retrieve the default profile 
ID using Profile Manager framework АРІ: NetPMGetDefaultProfileld. In this case NET EVENT - 
OPEN RSP will contain actual profile Id corresponding to default profile setting for which connection 
has been activated. 

For other positive values of Profileld, corresponding profiles will be used in connection. If the ProfileId 
is less than 0, error will be returned. 

If Connection is already active for the given profile, This API will share the active connection with the 
calling application. 

If Connection is already active for the given profile, and same application is trying to open connection, 
this API will return error. 


Notes : 


CM requests transport plug-in interface to open a new connection only if connection is not already estab- 
lished. If there is already a connection with same profile, then same connection will be shared. 


Warning: 
None 


Parameters: 
Profileld[ | [IN] Array of Profile IDs 
ProfileCount [IN] Number of IDs in the list 
Async Response Message: 


NET EVENT OPEN RSP: Connection Establishment response will be sent asynchronously to the 
App in the callback function registered as NET EVENT OPEN RSP event. 
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Precondition: 


Application must already be registered with the CM server. 


Returns: 


Return Type (int) 


NET ERR NONE - indicating that the operation has completed successfully. 

NET ERR INVALID CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 

NET ЕКЕ INVALID PARAM - indicating that API parameter value is invalid. 


NET ERR INVALID PROFILEID -indicating that profile ID parameter passed in the API is 
invalid. 


NET ERR, ACTIVE CONNECTION EXISTS -indicating that there is already a active connec- 
tion associated with the client for the requested profile ID. 


МЕТ ЕКЕ CONNECTION OPENING -indicating that the client has already requested open 
connection for the same profile ID. 


NET ERR, MAX CLIENTS PER, CONNECTION -indicating that connection is already being 
shared by maximum number of clients. 


NET ERR, MAX CONNECTIONS -indicating that maximum number of connection requests 
have already been processed by CM 


NET ЕКЕ INVALID OPERATION - indicating that open connection operation is not allowed 
in the current state. 

NET ЕКЕ TRANSPORT - Indicating that Transport error had happened; Client need to call 
NetCMGetTransportError to find error cause 


NET ERR, UNKNOWN -indicating that an unknown error has occured. 


Prospective Clients: 


External Apps. 


Example Program: 


int result; 
result  NetCMConnectionOpen( ProfileId ,ProfileCount); 
if(result == NET ERR, МОМЕ)...... 


6.1.4.6 int NetCMDeviceGetInfo (int Profileld, NetDevInfo t x DevInfo) 


This API shall get the device information associated with the connection referred by the Profileld. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


On success, device information will be copied into DevInfo parameter. Calling Application should 
allocate memory for the output parameter DevInfo. 
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This API returns NET ЕЕЕ NO ACTIVE CONNECTIONS if there is no active connection activated 
by the application with the requested profile ID. 
A positive integer is a valid value for the Profile ID 


Warning: 


None 


Notes: 


Calling application must have a active data connection associated with the Profileld. 


Parameters: 
Profileld |IN] Profile ID of the connection 


DevInfo [OUT] Structure to store device information. 


Async Response Message: 


None 


Precondition: 


Calling application must have a active data connection associated with the Profileld. 


Returns: 


Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 
* NET ERR INVALID PARAM - indicating that API parameter value is invalid. 


* NET ERR INVALID CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 


• NET ERR. NO ACTIVE CONNECTIONS -indicating that there is no active connection asso- 
ciated with the client for the requested profile ID. 


* NET ERR INVALID PROFILEID -indicating that profile ID parameter passed in the API is 
invalid. 


Prospective Clients: 


External Apps. 


Example Program: 


int result; 

NetDevInfo_t devInfo; 

result = NetCMDeviceGetInfo( ProfileId, &devInfo ); 
if(result == NET ERR, NONE)...... 
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6.1.47 іш NetCMGetActiveProfileIDs (int ProfileId| ], int х ProfileCount) 


This API will retrieve all active profile IDs. 


Sync (or) Async: 
This is a Synchronous API. 


Important Notes: 


API will return error if there is no active connections available. 

On Success, active profile ids will be copied to РгоШе]4 array and number of active profile will be 
updated in ProfileCount. 

Calling application should allocate memory for the output parameters ProfileId array and ProfileId- 
Count. ProfileId array should contain memory of size NET CONNECTIONS МАХ. 

A positive integer is a valid value for the Profile ID. 


Warning: 


API can be called by privileged application only. 


Parameters: 
Profileld| | [OUT] Array of active profile Identifiers.(Array of size NET CONNECTIONS МАХ) 
ProfileCount [OUT] Number of active profile Identifiers 


Async Response Message: 


None 


Precondition: 


Application must already be registered with the CM server. API must be called from privileged appli- 
cation only. 


Returns: 
Return Type (int) 
* NET ERR NONE - indicating that the operation has completed successfully. 
* NET ERR INVALID PARAM - indicating that API parameter value is invalid. 
e NET ERR, NO ACTIVE CONNECTIONS -indicating that there are no active connections. 


* NET ERR INVALID CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 


e NET ERR. UNKNOWN -indicating that an unknown error has occured. 


Prospective Clients: 


External Apps. 


Example Program: 
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int result; 

int Profileld(NNET PROFILE COUNT MAX]; 

int ProfileCount; 

result - NetCMGetActiveProfileIDs( ProfileId, &ProfileCount ); 
if(result == NET ERR, NONE).......... 


6.1.4.8 іш NetCMGetTransportError (int ж Error) 
This API returns transport specific error cause for the synchronous return of the last initiated API request. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


This АРІ is not required for retrieving transport specific errors for the asynchronous response of АРІ. 
Asynchronous response event already contains the transport error cause in the event data structure. 
If any other CM API returns failure with return value NET ERR. TRANSPORT, then client applica- 
tion can retrieve actual error cause through this API. 
API is a synchronous API and error will be stored in parameter Error passed in this API. 
Application has to allocate memory for the Error parameter. 
CM stores transport error value on per client basis. So, the same API can return different values for 
different clients. But, if the same application calls another CM API, the error reason is over-written 
and this API call may return a new error this time. 

Warning: 
None 


Parameters: 


Error [OUT] Transport error code 


Async Response Message: 


None 


Precondition: 


Application must already be registered with the CM server. 


Returns: 
Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 


* NET ERR INVALID CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 


* NET ERR INVALID PARAM - indicating that API parameter value is invalid. 


Prospective Clients: 


External Apps. 
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Example Program: 


int result; 

int Error; 

result = NetCMGetTransportError( &Error ); 
if(result == NET ERR, NONE).......... 


6.1.4.9 іш NetCMTunnelRequest (NetCMTunnellnfo t ж TunnelData) 
This API will be used to send any transport specific proprietary information to transport plug-in. 


Sync (or) Async: 
This is a ASynchronous API. 


Important Notes: 


API is a Non-Blocking API.Return value only implies whether the request is sent successfully or not. 
Return value Success does not imply that the request is successfully executed. 

Application has to allocate memory for the TunnelData parameter and TunnelData- » Data parameter. 
CM does not understand any internal data structure for tunnel request. Application should allocate 
memory for all the data and should not pass any unallocated pointer in TunnelData- ^ Data. 

CM will generate a unique request number and return it to application in Request Id member of struc- 
ture: NetCMTunnelInfo t. 


Warning: 
None 


Parameters: 


TunnelData [IN/OUT] Transport specific tunnel data. 


Async Response Message: 


NET EVENT TUNNEL RSP: Tunnel response will be sent asynchronously to the Application in the 
registered callback as NET EVENT TUNNEL RSP event 


Precondition: 


Application must already be registered with the CM server. 


Returns: 
Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 

* NET ERR INVALID CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 

* NET ERR INVALID PARAM - indicating that API parameter value is invalid. 


• NET ERR. MAX TUNNEL КЕО -indicating that maximum number of tunnel requests are al- 
ready being processed by CM 
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• NET ERR. UNKNOWN -indicating that an unknown error has occured. 
e МЕТ ERR TRANSPORT -indicating that Transport error had happened; Client need to call 


NetCMGetTransportError to find error cause 
Prospective Clients: 


External Apps. 


Example Program: 


NetCMTTunnelInfo t TunnelData; 

NetTransportType_t Transport; 

int result; 

result = NetCMTunnelRequest( Transport, &TunnelData ); 
if(result == NET ERR. МОМЕ).......... 
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6.2 Profile Manager 


Files 


* file PMIntf.h 


This file defines the interface of Profile Manager with the application/Connection Manager. 


Data Structures 


* union IpAddr t 
IP Address. 


* struct NetPdpQosGprs t 
PDP GPRS Qos Information. 


* struct NetPdpQosUmts t 
PDP UMTS(3G) Qos Information. 


* union Qos t 


Union of different type of Qos Info. 


* struct NetAddr t 


Network Address information. 


e struct NetPdpQoslInfo t 
PDP Qos Information. 


* struct NetAuthInfo t 


PDP Authentication Information. 


* struct NetPdpProfileInfo t 
PDP Profile Profile Information. 


* struct NetBssInfo t 
BSS Information. 


* struct NetWlanProfileInfo_t 
WLAN Profile Profile Information. 


* union ProfileInfo t 


Profile information : Union of PDP and WLAN profile information. 


* struct NetProfile t 


Profile data structures: Used between CM and PM Plug-in Interface. 
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Defines 


* #define NET РОР АСТН USERNAME LEN MAX 32 


Maximum length of username in PDP profile. 


• #define NET РОР AUTH, PASSWORD LEN MAX 32 
Maximum length of password іп PDP profile (used in authentication parameters) [3GPP Defined variable]. 


* #define NET РОР АРМ LEN MAX 255 
Maximum length of APN in PDP profile [3GPP Defined variable]. 


Enumerations 


enum NetProfileType t ( NET PROFILE TYPE PDP, NET PROFILE TYPE WLAN, NET - 
PROFILE TYPE ALL } 


Profile Type. 


enum NetAddrType t ( NET ADDR IPVA = 0x0, NET ADDR IPV6 = 0х1 } 
Address Type. 


enum NetAuthType_t ( NET_PDP_AUTH_NONE = 0x0, NET РОР AUTH PAP = 0х1, NET - 
PDP AUTH CHAP = 0x2] 


PDP Authentication Type. 


enum NetPdpQosType t ( NET РОР QOS GPRS, NET РОР QOS UMTS } 
PDP Qos Type. 


enum NetBssType t { МЕТ EVENT WLAN BSSTYPE INFRA, NET EVENT WLAN - 
BSSTYPE ADHOC, NET EVENT WLAN BSSTYPE BOTH ) 


BSS Information. 


Functions 


• int NetPMGetProfile (int ProfileId, NetProfile t Profile) 
This plug-in API should return the profile information referred by Profileld. 


• int NetPMGetDefaultProfileld (int «ProfileId) 
This plug-in API should return the default profile Id for CM. 


6.2.1 Define Documentation 


6.2.1.1 define NET РОР АРМ LEN MAX 255 


Maximum length of APN in PDP profile [3GPP Defined variable]. 
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6.2.1.2 Яйейпе NET РОР AUTH PASSWORD LEN MAX 32 


Maximum length of password in PDP profile (used in authentication parameters) [3GPP Defined variable]. 


6.2.1.3 #define МЕТ РОР AUTH USERNAME LEN MAX 32 


Maximum length of username in PDP profile. 


(used in authentication parameters) [3GPP Defined variable] 


6.2. Enumeration Type Documentation 
6.2.2.1 enum NetAddrType t 
Address Type. 


Enumerator: 


NET ADDR IPV4 ІРУ4 Address type. 
NET ADDR IPV6 IPV6 Address type. 


6.2.2.2 enum NetAuthType t 
PDP Authentication Type. 


Enumerator: 


NET PDP AUTH NONE No authentication. 
NET PDP AUTH PAP PAP authentication. 
NET PDP AUTH CHAP CHAP authentication. 


6.2.2.3 enum NetBssType t 


BSS Information. 


Enumerator: 
NET EVENT WLAN BSSTYPE INFRA Infrastructure type BSS. 


NET EVENT WLAN BSSTYPE ADHOC Adhoc type BSS. 
NET EVENT WLAN BSSTYPE BOTH Both types of BSS: Adhoc and Infrastructure. 


6.2.2.4 enum NetPdpQosType t 
PDP Qos Type. 


Enumerator: 


NET PDP QOS GPRS GPRS QoS information. 
NET PDP 008 UMTS UMTS QoS information. 
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6.2.2.5 enum NetProfileType t 
Profile Type. 


Enumerator: 


NET PROFILE TYPE PDP GPRS & WCDMA profiles. 
NET PROFILE TYPE WLAN WLAN profiles. 
NET PROFILE ТҮРЕ ALL All type of profile. 


6.2.3 Function Documentation 
6.2.3.1 int NetPMGetDefaultProfileld (int « ProfileId) 
This plug-in API should return the default profile Id for CM. 
Sync (or) Async: 

This is a Synchronous API. 


Important Notes: 


Connection Manager shall allocate and free memory for the output parameters ProfileId 
On success, default profile Id shall be copied to ProfileId 


Warning: 
None 
Parameters: 
Profileld [OUT] Profile Id will be returned. 
Async Response Message: 
None. 
Returns: 


Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 
* NET ERR INVALID PARAM -Invalid profile Id has been requested 
e NET ERR. UNKNOWN - Any Other error 


Prospective Clients: 
Connection Manager. 
Example Program: 
int Profileld; 
int result; 


result = NetPMGetDefaultProfileId( &Profileld ); 
if(result == МЕТ ERR, NONE)...... 
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6.2.3.2 int NetPMGetProfile (int ProfileId, NetProfile t « Profile) 


This plug-in АРІ should return the profile information referred by Profileld. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


On success, profile information shall be copied to Profile parameter in NetProfile t format 
Connection Manager shall allocate and free memory for the output parameters Profile (of size 
NetProfile t) 
Plug-in should not free memory allocated to Profile, if profile does not exist 
If profile does not exist, error shall be returned 
ProfileId is a positive integer and shall start from 1. 0 and negative values should not be used for 
ProfileId 

Warning: 


None 


Parameters: 
Profileld |IN] Profile Identifier. 
Profile [OUT] Buffer containing the profile. 


Async Response Message: 


None. 


Returns: 
Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully 
* NET ERR INVALID PROFILEID - Invalid profile Id has been requested 

* NET ERR INVALID PARAM - Input parameter is invalid( Profile is NULL) 
e NET ERR. UNKNOWN - Any Other error 


Prospective Clients: 


Connection Manager. 


Example Program: 


NetProfile t Profile; 


int ProfileId=1; 

int result; 

result = NetPMGetProfile( ProfileId, &Profile ); 
if(result == NET ERR, NONE)...... 
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6.3 PDP Transport Interface 


Files 


* file Transport3GIntf.h 
PDP Transport Interface. 


Data Structures 


e struct NetPdpConnInfo t 


Transport Error Cause. 


e union NetPDPConnectRspInfo t 


Connect Response event data. 


* struct NetPdpConnectRspEvInfo 


Connect Response event data. 


* struct NetPdpDisConnectRspEvInfo 


Connect Close Response event data. 


* struct NetPdpDisConnectIndEvInfo 


Connect Close Indication event data. 


* struct NetPdpSuspendIndEvInfo 


Connect Suspend Indication event data. 


* struct NetPdpResumeIndEvInfo 


Connect Resume Indication event data. 


* struct NetPdpTunnelEvInfo 


Tunnel Response Event Info. 


* union NetPdpTransportEventInfo t 


Connection Event Info. 


* struct NetPdpEventInfo t 
PDP Transport Event Info. 


Typedefs 


e typedef void(* NetPdpEvtCb )(const NetPdpEventInfo t «NetPdpEvent) 


Callback function Connection Manager needs to register a callback function with PDP transport plug-in to 
receive asynchronous events 
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Enumerations 


* enum NetPdpTransportEvent t { 


NET EVENT PDP ACTIVATION RSP, NET EVENT PDP DEACTIVATION RSP, NET - 
EVENT PDP DEACTIVATION IND, NET EVENT PDP SUSPEND IND, 


NET EVENT PDP RESUME IND, NET EVENT PDP TUNNEL } 
PDP Transport Asynchronous Event Type. 


Functions 


* int NetPDPInit (NetPdpEvtCb PdpEventCb, int *ReasonCode) 


This API shall initialize PDP Transport plug-in interface for CM 
PdpEventCb is the callback function that Connection Manager will register with PDP Transport Plug-in 
interface to receive PDP Transport events. 


• int NetPDPOpenConnection (unsigned int Connld, int Profileld, int «ReasonCode) 


This API shall bring up PDP connection with the profile information passed in profile parameter 
Connection Manager will use Connld passed in this API to Abort/Close the connection later 


• int NetPDPCloseConnection (unsigned int ConnId, int *ReasonCode) 


This API shall tear down PDP connection 
CM shall use this API to abort an on-going PDP Activation procedure. 


* int NetPdpDelnit (void) 
This API de-initializes the PDP Transport plug-in Interface for CM. 


• int NetPdpTunnelRequest (int ReqId, int DataLength, void «Data) 


This API will send the tunnel request to PDP transport Plug-in interface. 


6.31  Typedef Documentation 
6.3.1.1 typedef void(« NetPdpEvtCb)(const NetPdpEventInfo t «NetPdpEvent) 


Callback function Connection Manager needs to register a callback function with PDP transport plug-in to 
receive asynchronous events 


6.3.2 Enumeration Type Documentation 
6.3.2.1 enum NetPdpTransportEvent t 
PDP Transport Asynchronous Event Type. 


Enumerator: 


NET EVENT PDP ACTIVATION RSP Response event for NetPDPOpenConnection Request 
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Associated event information structure is :NetPdpConnectRspEvInfo ,member of structure 
NetPdpEventInfo t. 


Connld: Connection Identifier corresponding to the event. Passed by CM to Transport during 
open connection API. 


Status: Event Status. Either Success or Failure. 


ConnectRspInfo : This will be typecast either to ConnInfo or reason, based on Status. If Status 
is NET CM, SUCCESS then ConnectRspInfo will be typecast to ConnInfo, which contain the 
connection info. Otherwise ConnecRspInfo will be mapped to reason which informs that exact 
reason for connection failure. 


NET EVENT PDP DEACTIVATION RSP Response event for NetPDPCloseConnection Re- 
quest 


Associated event information structure is :NetPdpDisConnectRspEvInfo ,member of structure 
NetPdpEventInfo t. 


ConnlId: Connection Identifier corresponding to the event. Passed by CM to Transport during 
open connection API. 


Status: Event Status. Either Success or Failure. 
Reason: This will contain the reason if Status is NET CM. FAILURE.. 


NET EVENT PDP DEACTIVATION IND Notification event for PDP deactivation by network. 


Associated event information structure is :NetPdpDisConnectIndEvInfo ,member of structure 
NetPdpEventInfo t. 


Connld: Connection Identifier corresponding to the event. Passed by CM to Transport during 
open connection API. 


Reason: reason for connection termination. 
NET EVENT PDP SUSPEND IND Notification event when the data transfer in a connection is 
suspended. 


Associated event information structure is :NetPdpSuspendIndEvInfo ,member of structure 
NetPdpEventInfo t. 


ConnlId: Connection Identifier corresponding to the event. Passed by CM to Transport during 
open connection API. 


Reason: reason for connection suspend. 
NET EVENT PDP RESUME IND Notification event when the data transfer in a connection has 
resumed. 


Associated event information structure is :NetPdpResumeIndEvInfo ,member of structure 
NetPdpEventInfo t. 


ConnId: Connection Identifier corresponding to the event. Passed by CM to Transport during 
open connection API. 


Reason: reason for connection resumes. 
NET EVENT PDP TUNNEL Notification event for any other PDP specific event by Transport 
Plug-in interface. 


Associated event information structure is :NetPdpTunnelEvInfo ,member of structure 
NetPdpEventInfo t. 


Кеда: Request Id of the tunnel event. Transport Plug-in will return the same request ID which 
was used for calling the NetPdpTunnelRequest(). Its value should be invalid ( NET CM - 
INVALID ID) for unsolicited tunnel indication. 


Datalength: length of data pointed by Data variable. 


Data: Data pointer need to pass to application. 
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6.3.3 Function Documentation 
6.3.3.1 іш NetPDPCloseConnection (unsigned int ConnId, int  ReasonCode) 


This API shall tear down PDP connection 
CM shall use this API to abort an on-going PDP Activation procedure. 


It also shall be used to close an active connection. 


Sync (or) Async: 


This is a Asynchronous API. 


Important Notes: 


1) ConnId is the connection identifier which was used while making the connection using Net- 
PDPOpenConnection API. 

2) This function's returned value should imply whether the request is accepted or not. Success return 
does not mean that the connection is disconnected successfully. 

3) If API returns failure then exact reason code will be returned in ReasonCode variable. 

4) On receiving PDP De-Activation response from network, plug-in shall send the response with 
NET EVENT РОР DEACTIVATION КР event and Сопп to connection manager. 


Warning: 


None 


Parameters: 
Connld [IN] Connection Identifier. 


ReasonCode [OUT] Reason code for failure of API. If API returns success then this output parameter 
is invalid. 
Async Response Message: 


None. 


Precondition 


Connection manager should already register callback function with transport plug-in 
Connection should have requested for opening a PDP connection 


Returns: 


Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 


* NET ERR, TRANSPORT - Transport Error; Exact error cause has been returned in reason code 
variable 


Prospective Clients: 


Connection Manager. 
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6.3.3.2 int NetPdpDelnit (void) 


This API de-initializes the PDP Transport plug-in Interface for CM. 
The API will deregister the CM callback function which has been registered with PDP transport Interface. 
Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
None 

Warning: 
None 

Async Response Message: 
None. 

Precondition 


CM should have initialized the PDP transport Interface. 


Returns: 
Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 


* NET ERR, TRANSPORT - Transport Error; Exact error cause has been returned in reason code 
variable 


Prospective Clients: 


Connection Manager. 


6.3.3.3 int NetPDPInit (NetPdpEvtCb PdpEventCb, int  ReasonCode) 


This API shall initialize PDP Transport plug-in interface for CM 


PdpEventCb is the callback function that Connection Manager will register with PDP Transport Plug-in 
interface to receive PDP Transport events. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


Transport plug-in shall send all the PDP related events through the registered callback function. 

CM will call this API if PDP transport is not initialized before. 

Success return implies that PDP transport initialization has happened successfully and Callback has 
been registered successfully for sending asynchronous PDP transport events 

If failure is returned, then Transport Plug-in need to provide the reason for error in ReasonCode vari- 
able 
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Warning: 
None 


Parameters: 
PdpEventCb [IN] Callback function to receive PDP transport event. 
ReasonCode [OUT] Reason code for failure of API. If API returns success then this output parameter 
is invalid. 
Async Response Message: 


None. 


Returns: 
Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 


* NET ERR, TRANSPORT - Transport Error; Exact error cause has been returned in reason code 
variable 


Prospective Clients: 


Connection Manager. 


6.3.3.4 int NetPDPOpenConnection (unsigned int Соп а, int Profileld, int ж ReasonCode) 


This API shall bring up PDP connection with the profile information passed in profile parameter 


Connection Manager will use Сотпа passed in this API to Abort/Close the connection later 


Sync (or) Async: 
This is a ASynchronous API. 


Important Notes: 


1) Connld passed shall be used to refer to the connection 

2) Transport Plug-in will pass the Connld in the event info while calling callback function. 

3) Transport Plug-in will read the data corresponding to Profile id "ProfileID" from the Profile Manager 
4) This is an Asynchronous API; Plug-in should return immediately after taking the request. 

5) This function's return values should imply whether the request is accepted or not. Success, returned 
value, does not mean that the connection is established successfully. 

6) If API returns failure, then Transport plug-in will not try for open connection. Transport Plug-in 
will return exact reason in ReasonCode variable. 

7) On successful PDP connection, PDP Transport plug-in shall send response with NET EVENT - 
РОР ACTIVATION КР event and ConnId to connection manager. The status member of event info 
must be NET CM SUCCESS. 

8)On Unsuccessful PDP connection, PDP Transport plug-in shall send response with NET EVENT - 
РОР ACTIVATION КР event and Connld to connection manager. The status member of event info 
must be NET CM FAILURE 


Warning: 


None 
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Parameters: 


Connld [IN] Connection Identifier, CM will generate a unique connection identifier which will be 
passed to PDP Transport Plug-in device. 


ProfileId [IN] Profile Indentifier 


ReasonCode [OUT] Reason code for failure of API. If API returns success then this output parameter 
is invalid. 
Async Response Message: 


None. 


Precondition 


Connection manager should already register callback function with transport plug-in. 


Returns: 
Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 


* NET ERR, TRANSPORT - Transport Error; Exact error cause has been returned in reason code 
variable 


Prospective Clients: 


Connection Manager. 


6.3.3.5 int NetPdpTunnelRequest (int RegId, int DataLength, void х Data) 


This API will send the tunnel request to PDP transport Plug-in interface. 


Sync (or) Async: 
This is a ASynchronous API. 


Important Notes: 


1) The tunnel request is always accepted and this API always returns success, Any kind of error value 
18 reported using asynchronous response 

2) API will pass request id to Transport Plug-in. Same Request Id will be used for the tunnel response 
3) CM will generate Request Id and use the same for tunnel Request-Response matching. 

4) Transport PlugIn should send Response for each submitted tunnel request. 


Warning: 


None 


Parameters: 
Reqld ПМ] CM generated Request Id used for matching the tunnel Request and Response. 
DataLength [IN] Length of data passed in data. 
Data |IN] Tunnel data passed to Transport plug-in. 
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Async Response Message: 
None. 


Precondition 


CM should have initialized the PDP transport Interface. 


Returns: 
Return Type (int) 
* NET ERR NONE - indicating that the operation has completed successfully. 


Prospective Clients: 


Connection Manager. 


Usage: 
PDP Modification, MT PDP indication etc 
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6.4 WLAN Transport Interface 


Files 


• file TransportWlanIntf.h 
WLAN Transport Interface. 


Data Structures 


* struct NetWlanConnInfo t 


Transport Error Cause. 


union NetWlanConnectRspInfo t 


Connect Response event data. 


struct NetWlanConnectRspEvInfo 


Connect Response event data. 


struct NetWlanDisConnectRspEvInfo 


Connect Close Response event data. 


struct NetWlanDisConnectIndEvInfo 


Connect Close Indication event data. 


struct NetWlanTunnelEvInfo 


Tunnel Response Event Info. 


union NetWlanTransportEventInfo_t 


Connection Event Info. 


struct NetWlanEventInfo t 
WLAN Transport Event Info. 


Typedefs 


е typedef void(« NetWlanEvtCb )(const NetWlanEventInfo_t «NetW]anEvent) 


Callback function Connection Manager needs to register a callback function with WLAN transport plug-in 
to receive asynchronous events 


Enumerations 


* enum NetWlanTransportEvent t { NET EVENT WLAN CONNECTION RSP, NET EVENT - 
WLAN DISCONNECTION RSP, МЕТ EVENT WLAN DISCONNECTION IND, NET- 
EVENT WLAN TUNNEL } 


WLAN Transport Asynchronous Event Type. 
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Functions 


• int NetWlanInit (NetWlanEvtCb WlanEventCb, int «ReasonCode) 
This API shall initialize WLAN Transport plug-in interface for CM. 


e int NetWlanOpenConnection (unsigned int Connld, int Profileld, int «ReasonCode) 


This API shall bring up WLAN connection with the profile information passed in profile parameter 
Connection Manager will use Connld passed in this API to Abort/Close the connection later 


e int NetWlanCloseConnection (unsigned int Connld, int «ReasonCode) 


This API shall tear down WLAN connection 
CM shall use this API to abort an on-going WLAN connection procedure. 


* int NetWlanDelnit (void) 
This API de-initializes the WLAN Transport plug-in Interface for CM. 


e int NetWlanTunnelRequest (int RegId, int DataLength, void Data) 


This API will send the tunnel request to WLAN transport Plug-in interface. 


6.41  Typedef Documentation 
6.4.1.1 typedef void(« NetWlanEvtCb)(const NetWlanEventInfo t «NetWlanEvent) 


Callback function Connection Manager needs to register a callback function with WLAN transport plug-in 
to receive asynchronous events 


6.4.2 Enumeration Type Documentation 
6.4.2.1 enum NetWlan' TransportEvent t 


WLAN Transport Asynchronous Event Type. 


Enumerator: 


NET EVENT WLAN CONNECTION RSP Response event for NetWlanOpenConnection Re- 
quest 


Associated event information structure is :NetWlanConnectRspEvInfo ,member of structure 
NetWlanEventInfo_t. 

ConnlId: Connection Identifier corresponding to the event. Passed by CM to Transport during 
open connection API. 

Status: Event Status. Either Success or Failure. 

ConnectRspInfo: This will typecast either to ConnInfo or reason, based on Status. If Status is 
NET CM SUCCESS then ConnectRspInfo will be typecast to ConnInfo that contains the con- 


nections info. Otherwise ConnectRspInfo will be mapped to reason informing the exact reason 
for connection failure. 
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NET EVENT WLAN DISCONNECTION RSP Response event for NetWlanCloseConnection 
Request 


Associated event information structure is :NetWlanDisConnectRspEvInfo ,member of structure 
NetWlanEventInfo t. 

Connld: Connection Identifier corresponding to the event. Passed by CM to Transport during 
open connection API. 

Status: Event Status. Either Success or Failure. 

Reason: This will contain the reason if Status is NET CM. FAILURE. 


NET EVENT WLAN DISCONNECTION IND Notification event when WLAN connection is 
lost by Transport Plug-in Interface. 


Associated event information structure is :NetWlanDisConnectIndEvInfo member of structure 
NetWlanEventInfo t. 
Соп: Connection Identifier corresponding to the event. Passed by CM to Transport during 
open connection API. 


Reason: reason for connection termination. 


NET EVENT WLAN TUNNEL Notification event for any other WLAN specific event by Trans- 
port Plug-in interface. 


Associated event information structure is :NetWlanTunnelEvInfo ,member of structure 
NetWlanEventInfo_t. 

ReglId: Request Id of the tunnel event. Transport Plug-in will return the same request ID which 
was used for calling the NetWlanTunnelRequest(). It should be invalid (NET_CM_INVALID_ID 
) for unsolicited tunnel indication. 


DataLength: length of data pointed by Data variable. 
Data: Data pointer need to pass to application. 


6.4.3 Function Documentation 
6.4.3.1 int NetWlanCloseConnection (unsigned int ConnId, int ж ReasonCode) 


This API shall tear down WLAN connection 
CM shall use this API to abort an on-going WLAN connection procedure. 


It also shall be used to close an active connection. 


Sync (or) Async: 


This is a Asynchronous API. 


Important Notes: 


1) Connld is the connection identifier which was used while making the connection using 
NetWlanOpenConnection API. 

2) This function’s returned value should imply whether the request is accepted or not. Success return 
does not mean that the connection is disconnected successfully. 

3) If API returns failure then exact reason code will be returned in ReasonCode variable. 

4) On receiving WLAN Connection Close response from network, plug-in shall send the response with 
NET_EVENT_WLAN_DEACTIVATION_RSP event and Connld to connection manager. 


Warning: 


None 
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Parameters: 


Connld [IN] Connection Identifier 


ReasonCode [OUT] Reason code for failure of API. If API returns success then this output parameter 
is invalid. 


Async Response Message: 
None. 


Precondition: 


Connection manager will have already registered a callback function with transport plug-in 
Connection should have requested for opening a WLAN connection 


Returns: 
Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 


* NET ERR, TRANSPORT - Transport Error; Exact error cause has been returned in reason code 
variable 


Prospective Clients: 


Connection Manager. 


6.4.3.2 int NetWlanDelnit (void) 


This API de-initializes the WLAN Transport plug-in Interface for CM. 


The API will deregister the CM callback function which has been registered with WLAN transport Inter- 
face. 


Sync (or) Async: 

This is a Synchronous API. 
Important Notes: 

None 
Warning: 

None 


Async Response Message: 


None. 


Precondition: 


CM should have initialized the WLAN transport Interface 


Returns: 


Return Type (int) 
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* NET ERR NONE - indicating that the operation has completed successfully. 


* NET ERR, TRANSPORT - Transport Error; Exact error cause has been returned in reason code 
variable 


Prospective Clients: 


Connection Manager. 


6.4.33 int NetWlanInit (NetWlanEvtCb WlanEventCb, int ж ReasonCode) 


This API shall initialize WLAN Transport plug-in interface for CM. 


WlanEventCb is the callback function that CM will register with WLAN Transport Plug-in to receive 
WLAN event from WLAN transport interface. 


Sync (or) Async: 
This is a Synchronous API. 


Important Notes: 


Transport plug-in shall send all the WLAN related events through the registered callback function. 
CM will call this API if WLAN transport is not initialized before. 
Success return value implies that WLAN transport initialization has happened successfully and call- 
back has been registered to WLAN Transport Plug-in for sending asynchronous WLAN transport 
events 
If failure is returned, then Transport need to provide the exact reason for error in ReasonCode which 
will be forwarded to application 

Warning: 


None 


Parameters: 


WlanEventCb [IN] Callback function to receive WLAN event from WLAN transport device. 


ReasonCode [OUT] Reason code for failure of API. If API returns success then this output parameter 
is invalid. 


Async Response Message: 
None. 
Precondition: 


CM will call this function if Transport is not being initialized. 


Returns: 


Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 


* NET ERR, TRANSPORT - Transport Error; Exact error cause has been returned in reason code 
variable 


Prospective Clients: 


Connection Manager. 
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6.4.3.4 іш NetWlanOpenConnection (unsigned int Connld, int Profileld, int х ReasonCode) 


This API shall bring up WLAN connection with the profile information passed in profile parameter 


Connection Manager will use ConnId passed in this API to Abort/Close the connection later 


Sync (or) Async: 
This is a ASynchronous API. 


Important Notes: 


1) Connld passed shall be used to refer to the connection 

2) Transport Plug-in will pass the Connld in the event info while calling registered callback function. 

3) Transport Plug-in will read the data corresponding to Profile id "ProfileID" from the Profile Man- 
ager. 

3) This function's return values should imply whether the request is accepted or not. Success, returned 
value, does not mean that the connection is established successfully. 

4) If API returns failure, then Transport plug-in will not try for open connection. Transport Plug-in 
will return exact reason in ReasonCode variable. 

5) On successful WLAN connection, WLAN Transport plug-in shall send response with NET - 
EVENT WLAN. CONNECTION RSP event and Connld to connection manager. The status member 
of event info must be NET CM. SUCCESS. 

6) On Unsuccessful WLAN connection, WLAN Transport plug-in shall send response with NET - 
EVENT WLAN. CONNECTION КӨР event and Connld to connection manager. The status member 
of event info must be NET CM, FAILURE. The reason member of event info should contain the exact 
reason code which will be forwarded to application. 


Warning: 


None 


Parameters: 


Connld [IN] Connection Identifier, CM will generate a unique connection identifier which will be 
passed to WLAN Transport Plug-in device. 


Profileld [IN] Profile Indentifier 


ReasonCode [OUT] Reason code for failure of API. If API returns success then this output parameter 
is invalid. 
Async Response Message: 


None. 


Precondition: 


Connection manager will have already registered a callback function with transport plug-in. 


Returns: 
Return Type (int) 


* NET ERR NONE - indicating that the operation has completed successfully. 


* NET ERR, TRANSPORT - Transport Error; Exact error cause has been returned in reason code 
variable 
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Prospective Clients: 


Connection Manager. 


6.4.3.5 int NetWlanTunnelRequest (int ReglId, int DataLength, void х Data) 


This API will send the tunnel request to WLAN transport Plug-in interface. 


Sync (or) Async: 
This is a ASynchronous API. 


Important Notes: 


1) The tunnel request is always accepted and this API always returns success, Any kind of error value 
18 reported using asynchronous response 

2) API will pass request id to Transport Plug-in. Same Request Id will be used for the tunnel response 
3) CM will generate Request Id and use the same for tunnel Request-Response matching. 

4) Transport PlugIn should send Response for each submitted tunnel request. 


Warning: 
None 
Parameters: 
Reqld [IN] CM generated Request Id used for matching the tunnel Request and Response. 


DataLength [IN] Length of data passed in data. 
Data |IN] Tunnel data passed to Transport plug-in. 


Async Response Message: 
None. 


Precondition: 


CM should have initialized the WLAN transport Interface 


Returns: 
Return Type (int) 
* NET ERR NONE - indicating that the operation has completed successfully. 


Prospective Clients: 


Connection Manager. 


Usage: 


Scan, configure QoS, Background scan etc 
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7.1 IpAddr t Union Reference 


7.1.4 Detailed Description 


IP Address. 


Data Fields 


* struct in addr Ipv4 
IP Version 4 address. 


e struct in6 адаг Ipv6 
IP Version 6 address. 


7.1.2 Field Documentation 
7.1.2.1 struct in_addr IpAddr_t::Ipv4 [read] 


IP Version 4 address. 


7.1.2.2 struct in6_addr IpAddr_t::Ipv6 [read] 


IP Version 6 address. 


The documentation for this union was generated from the following file: 


* PMIntf.h 
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7.2 NetAddr t Struct Reference 


7.2.1 Detailed Description 


Network Address information. 


Data Fields 


* NetAddrType t Type 
Address Type: IPv4 or IPv6. 


* [pAddr t Data 
IP Address. 


7.2.2 Field Documentation 
7.2.2.1  NetAddrType t NetAddr t::Type 


Address Type: IPv4 or IPv6. 


7.2.2.2 IpAddr t NetAddr t::Data 


ІР Address. 


The documentation for this struct was generated from the following file: 


* PMIntf.h 
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7.3  NetAuthInfo t Struct Reference 


7.3.1 Detailed Description 


PDP Authentication Information. 


Data Fields 


e NetAuthType t Auth Type 


Authentication type. 


* char UserName [NET РОР AUTH USERNAME LEN MAX] 


UserName to be used during authentication. 


* char Password [NET РОР AUTH PASSWORD LEN MAX] 


Password to be used during authentication. 


7.3.2 Field Documentation 
7.3.2.1  NetAuthType t NetAuthInfo t::AuthType 


Authentication type. 


7.3.2.2 char NetAuthInfo t::UserName[NET РОР AUTH USERNAME LEN MAX] 


UserName to be used during authentication. 


7.3.2.3 char NetAuthInfo t::PasswordiNET РОР AUTH PASSWORD LEN MAX] 


Password to be used during authentication. 


The documentation for this struct was generated from the following file: 


* PMIntf.h 
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7.4 NetBssInfo t Struct Reference 


7.4.1 Detailed Description 


BSS Information. 


Data Fields 


* char Ssid [32] 
WLAN SSID. 


e unsigned char В5514 [6] 
WLAN BSSID. 


* NetBssType t BssType 
WLAN BSS Type. 


7.4.0 Field Documentation 
7.4.2.4 char NetBssInfo t::Ssid[32] 


WLAN SSID. 


7.4.2.2 unsigned char NetBssInfo t::BssId[6] 


WLAN BSSID. 


7.4.2.3 NetBssType t NetBssInfo t::BssType 


WLAN BSS Type. 


The documentation for this struct was generated from the following file: 


* PMIntf.h 
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7.5 NetCMTunnelInfo t Struct Reference 


7.5.1 Detailed Description 


Tunnel data: Used in sending tunnel request to Connection Manager. 


Data Fields 


* NetTransportType t Transport 
Transport type. 


• int RequestId 
Request ID. 


* int DataLength 
Length of tunnel data. 


* void х Data 


tunnel data 


7.5.22 Field Documentation 
7.5.2.1 NetTransportType t NetCMTunnelInfo_t::Transport 


Transport type. 


7.5.2.2 int NetCM TunnelInfo t::RequestId 


Request ID. 


7.5.2.3 int NetCMTunnellInfo t::DataLength 


Length of tunnel data. 


7.5.2.4 void« NetCM TunnelInfo t::Data 


tunnel data 


The documentation for this struct was generated from the following file: 


* NetCMIntf.h 
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7.6 NetDevInfo t Struct Reference 
7.6.1 Detailed Description 


Device Info in Connect response event. 


Data Fields 


* int Profileid 


Profile ID for the connection connect response. 


char DevName [NET DEVICE NAME LEN MAX] 


Device Name of the connection link. 


NetAddr t DnsAddr [NET DNS ADDR MAX] 


Dns Server Address of the connection link. 


int DnsCount 
No of DNS Address for the connection link. 


NetAddr t IpAddr 


IP Address for the connection link. 


boolean BNetmask 


Whether subnet mask present or not. 


NetAddr t SubnetMask 


Subnet mask. 


boolean BDefGateway 


Whether gateway address present or not. 


NetAddr t GatewayAddr 


Gateway address. 


7.6.2 Field Documentation 
7.6.2.1 int NetDevInfo t::Profileid 


Profile ID for the connection connect response. 


7.6.2.2 char NetDevInfo t::DevName[NET DEVICE NAME LEN MAX] 


Device Name of the connection link. 


7.6.2.3 NetAddr t NetDevInfo t::DnsAddr[NET DNS ADDR МАХ] 


Dns Server Address of the connection link. 
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7.6.2.4 int NetDevInfo t::DnsCount 


No of DNS Address for the connection link. 


7.6.2.5 NetAddr t NetDevInfo t::IpAddr 


IP Address for the connection link. 


7.6.2.6 boolean NetDevInfo t::BNetmask 


Whether subnet mask present or not. 


7.6.2.7] NetAddr t NetDevInfo t::SubnetMask 


Subnet mask. 


7.6.2.8 boolean NetDevInfo t::BDefGateway 


Whether gateway address present or not. 


7.6.2.9 NetAddr t NetDevInfo t::GatewayAddr 


Gateway address. 


The documentation for this struct was generated from the following file: 


* NetCMIntf.h 
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77 NetEventInfo t Struct Reference 


7.7.4 Detailed Description 


Event Info with Event on callback from Connection Manager. 


Data Fields 


* NetEvent t Event 


CM Asynchronous event. 


* int ProfileId 


Profile Identifier corresponding to the event. 


* NetErr t Error 


Event Status. 
* void х Data 


Event data: Depending on the event, Event Data will be typecasted to the approprate event info data struc- 
ture. 


77.2 Field Documentation 
7.7.21 NetEvent t NetEventInfo t::Event 


CM Asynchronous event. 


7.7.2.2 int NetEventInfo t::ProfileId 


Profile Identifier corresponding to the event. 


77.2.3 NetErr t NetEventInfo t::Error 


Event Status. 


7.7.2.4  void« NetEventInfo t::Data 


Event data: Depending on the event, Event Data will be typecasted to the approprate event info data 
structure. 


The documentation for this struct was generated from the following file: 


* NetCMIntf.h 
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7.8 NetEventTunnelIndInfo t Struct Reference 


7.8.1 Detailed Description 


Event Info with Event on Indication from Connection Manager. 


Data Fields 


* NetEvent_t Event 


CM Asynchronous Indication. 


* NetTransportType t TransportType 


Transport type of Tunnel Indication. 


* int Len 
length of the data buffer 


e void ж Data 
Event Data Buffer. 


7.8.2 Field Documentation 
7.8.2.1 NetEvent t NetEventTunnelIndInfo t::Event 


CM Asynchronous Indication. 


7.8.2.2 NetTransportType t NetEventTunnelIndInfo t::TransportType 


Transport type of Tunnel Indication. 


7.8.2.3 int NetEventTunnelIndInfo_t::Len 


length of the data buffer 


7.8.2.4 void« NetEventTunnelIndInfo t::Data 


Event Data Buffer. 


The documentation for this struct was generated from the following file: 


* NetCMIntf.h 
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7.9 NetPdpConnectRspEvInfo Struct Reference 


7.9.1 Detailed Description 


Connect Response event data. 


Data Fields 


e unsigned int ConnId 


Connection Identifier. 


* int Status 
Status value of connection Response indication. 
• NetPDPConnectRsplInfo t ConnectRspInfo 
This will be typecast either to connInfo or reason, based on Status 
Status is NET CM SUCCESS then connectRspInfo will be typecast to connInfo, which contain the connec- 


tion info 
Otherwise connecRspInfo will be mapped to reason which informs that exact reason for connection failure 


7.9.2 Field Documentation 
7.9.2.1] unsigned int NetPdpConnectRspEvInfo::ConnId 


Connection Identifier. 


7.9.2.2 int NetPdpConnectRspEvInfo::Status 


Status value of connection Response indication. 


7.9.2.3 NetPDPConnectRspInfo t NetPdpConnectRspEvInfo::ConnectRspInfo 


This will be typecast either to connInfo or reason, based on Status 


Status is NET CM, SUCCESS then connectRspInfo will be typecast to connInfo, which contain the con- 
nection info 


Otherwise connecRspInfo will be mapped to reason which informs that exact reason for connection failure 


The documentation for this struct was generated from the following file: 


* Transport3GIntf.h 
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7.10 NetPDPConnectRspInfo t Union Reference 


7.10.1 Detailed Description 


Connect Response event data. 


Data Fields 


* NetPdpConnInfo t ConnInfo 


Connection Info. 


* int Reason 


Reason Code for failure. 


7.10.2 Field Documentation 
7.10.2.1 NetPdpConnInfo_t NetPDPConnectRspInfo_t::ConnInfo 


Connection Info. 


7.10.2.2 int NetPDPConnectRspInfo_t::Reason 


Reason Code for failure. 


The documentation for this union was generated from the following file: 


* Transport3GIntf.h 
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7.11 NetPdpConnInfo t Struct Reference 


7.11.1 Detailed Description 


Transport Error Cause. 


Data Fields 


e unsigned int ConnId 
PDP Connection identifier. 


* char DevName [NET DEVICE NAME LEN MAX] 


Device name created for this connection. 


* int DnsCount 
No of valid DNS address. 


e NetAddr t DnsAddr [NET ОМЅ ADDR MAX] 
DNS Addresses for this connection. 


* NetAddr t IpAddr 
IP Address for this connection. 


7.11.2 Field Documentation 
7.11.2.1 unsigned int NetPdpConnInfo t::ConnId 


PDP Connection identifier. 


7.11.2.2 char NetPdpConnlInfo t::DevName[NET DEVICE NAME LEN MAX] 


Device name created for this connection. 


7.11.2.3 int NetPdpConnInfo_t::DnsCount 


No of valid DNS address. 


7.11.2.4 NetAddr t NetPdpConnInfo t::DnsAddr[NET DNS ADDR MAX] 


DNS Addresses for this connection. 


7.11.2.5 NetAddr t NetPdpConnInfo_t::IpAddr 


IP Address for this connection. 


The documentation for this struct was generated from the following file: 


* Transport3GIntf.h 
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7.12 NetPdpDisConnectIndEvInfo Struct Reference 


7.12.1 Detailed Description 


Connect Close Indication event data. 


Data Fields 


e unsigned int ConnId 


Connection Identifier. 


* int Reason 


reason for connection termination 


7.12.2 Field Documentation 
7.12.2.1 unsigned int NetPdpDisConnectIndEvInfo::ConnId 


Connection Identifier. 


7.12.2.2 int NetPdpDisConnectIndEvInfo::Reason 


reason for connection termination 


The documentation for this struct was generated from the following file: 


* Transport3GIntf.h 
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7.13 NetPdpDisConnectRspEvInfo Struct Reference 


7.13.1 Detailed Description 


Connect Close Response event data. 


Data Fields 


e unsigned int ConnId 


Connection Identifier. 


* int Status 


Status value of connection Response indication. 


* int Reason 
This will contain the reason if Status is NET CM FAILURE. 


7.13.2 Field Documentation 
7.13.2.1 unsigned int NetPdpDisConnectRspEvInfo::ConnId 


Connection Identifier. 


7.13.2.2 int NetPdpDisConnectRspEvInfo::Status 


Status value of connection Response indication. 


7.13.2.3 int NetPdpDisConnectRspEvInfo::Reason 


This will contain the reason if Status is NET CM. FAILURE. 


The documentation for this struct was generated from the following file: 


* Transport3GIntf.h 
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7.14  NetPdpEventInfo t Struct Reference 


7.14.1 Detailed Description 


PDP Transport Event Info. 


Data Fields 


* NetPdpTransportEvent t EventId 
PDP Asynchronous Event ID. 


* NetPdpTransportEventInfo t EventInfo 


PDP Event Information 

Plug-in will allocate the memory for event data 

Once Context returns from callback then plug-in will free the memory allocated to event data 
See section or later for Eventld and EventInfo detail 


7.14.2 Field Documentation 
7.14.21  NetPdpTransportEvent t NetPdpEventInfo t::EventId 


PDP Asynchronous Event ID. 


7.14.2.2 NetPdpTransportEventInfo t NetPdpEventInfo t::EventInfo 


PDP Event Information 
Plug-in will allocate the memory for event data 
Once Context returns from callback then plug-in will free the memory allocated to event data 


See section or later for EventId and EventInfo detail 


The documentation for this struct was generated from the following file: 


* Transport3GIntf.h 
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7.15 NetPdpProfileInfo_t Struct Reference 


7.15.1 Detailed Description 


PDP Profile Profile Information. 


Data Fields 


* boolean BPrimaryPdpProfile 
Primary or Secondary PDP profile. 


int PrimaryPdpProfileId 
If Sec PDP profile then Profile Id of primary PDP. 


char Apn [NET PDP APN LEN MAX] 


Network Access Point Name. 


boolean BStaticIpAddr 
Static or Dynamic IP Address. 


NetAddr t IpAddr 
IP address. 


boolean BStaticDnsAddr 
Static or Dynamic DNS Address. 


int DnsCount 
No of DNS Addresses. 


NetAddr t DnsAddr [NET DNS. ADDR. MAX] 
DNS Addresses. 


NetPdpQosInfo t QosInfo 
QoS information of PDP Profile. 


NetAuthInfo t AuthInfo 
Authentication info of the PDP profile. 


7.15.2 Field Documentation 
7.15.2.1 boolean NetPdpProfileInfo t::BPrimaryPdpProfile 


Primary or Secondary PDP profile. 


7.15.2.2 int NetPdpProfileInfo t::PrimaryPdpProfileId 


If Sec PDP profile then Profile Id of primary PDP. 
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7.15.2.3 char NetPdpProfileInfo t::Apn[NET PDP APN LEN MAX] 


Network Access Point Name. 


7.15.2.4 boolean NetPdpProfileInfo t::BStaticIpAddr 


Static or Dynamic IP Address. 


7.15.2.5 NetAddr t NetPdpProfileInfo t::IpAddr 


IP address. 


7.15.2.6 boolean NetPdpProfileInfo t::BStaticDnsAddr 


Static or Dynamic DNS Address. 


7.15.27 int NetPdpProfileInfo t::DnsCount 


No of DNS Addresses. 


7.15.2.8 NetAddr t NetPdpProfileInfo t::DnsAddr[NET DNS ADDR MAX] 


DNS Addresses. 


7.15.2.9 NetPdpQosInfo t NetPdpProfileInfo t::QosInfo 


QoS information of PDP Profile. 


7.15.2.10  NetAuthInfo t NetPdpProfileInfo t::AuthInfo 


Authentication info of the PDP profile. 


The documentation for this struct was generated from the following file: 


* PMIntf.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 
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7.16 NetPdpQosGprs_t Struct Reference 


7.16.1 Detailed Description 


PDP GPRS Qos Information. 


Data Fields 


* int Precedence 


Precedence class. 


* int Delay 
Delay class. 


* int Reliability 
Reliability class. 


* int Peak 
Peak throughput class. 


* int Mean 


Mean throughput class. 


7.16.2 Field Documentation 
7.16.2.1 int NetPdpQosGprs t::Precedence 


Precedence class. 


7.16.2.2 int NetPdpQosGprs t::Delay 


Delay class. 


7.16.2.3 int NetPdpQosGprs t::Reliability 


Reliability class. 


7.16.2.4 int NetPdpQosGprs t::Peak 


Peak throughput class. 


7.16.2.5 int NetPdpQosGprs t::Mean 


Mean throughput class. 


The documentation for this struct was generated from the following file: 


* PMIntf.h 
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7.17  NetPdpQosInfo t Struct Reference 


7.17.1 Detailed Description 


PDP Qos Information. 


Data Fields 


* NetPdpQosType t QosType 
PDP QOS type. 


* Qos t Qos 


Qos Information based on QoS type. 


7.17.2 Field Documentation 
7.17.2.1  NetPdpQosType t NetPdpQosInfo t::QosType 


PDP QOS type. 


7.17.2.2 Qos t NetPdpQosInfo_t::Qos 


Qos Information based on QoS type. 


The documentation for this struct was generated from the following file: 


* PMIntf.h 
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7.18  NetPdpQosUmts t Struct Reference 


7.18.4 Detailed Description 


PDP UMTS(3G) Qos Information. 


Data Fields 


* int Precedence 


Precedence class. 


* int Delay 


Delay class. 


* int Reliability 
Reliability class. 


* int Peak 
Peak throughput class. 


* int Mean 


Mean throughput class. 


* int TrafficClass 
Traffic Class. 


e int MaxUlBitrate 


Maximum bit rate for uplink. 


* int MaxD]Bitrate 


Maximum bit rate for downlink. 


* int GtdUlBitrate 


Guaranteed bit rate for uplink. 


* int GtdDlBitrate 


Guaranteed bit rate for downlink. 


* int DivryOrder 
Delivery Order. 


* int MaxSduSize 
Maximum SDU(Service Data Unit ) Size. 


* int SduErr 
SDU Error Ratio. 


* int ResBitErr 
Residual BER(Bit Error). 
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• int DivrErrSdu 


Delivery of erroneous SDU. 


* int TransDelay 


Transfer Delay. 


* int ThandlePrio 


Traffic Handling Priority. 


7.18.2 Field Documentation 


7.18.2.1 int NetPdpQosUmts t::Precedence 


Precedence class. 


7.18.2.2 int NetPdpQosUmts t: 


Delay class. 


7.18.2.3 int NetPdpQosUmts t: 


Reliability class. 


7.18.2.4 int NetPdpQosUmts t: 


Peak throughput class. 


7.18.2.5 int NetPdpQosUmts t: 


Mean throughput class. 


7.18.2.6 int NetPdpQosUmts t: 


Traffic Class. 


7.18.2.7 int NetPdpQosUmts t: 


Maximum bit rate for uplink. 


7.18.2.8 int NetPdpQosUmts t: 


Maximum bit rate for downlink. 


:Delay 


:Reliability 


:Peak 


:Mean 


:TrafficClass 


:MaxUlBitrate 


:MaxDlBitrate 
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7.18.2.9 int NetPdpQosUmts t::GtdUlBitrate 


Guaranteed bit rate for uplink. 


7.18.2.10 int NetPdpQosUmts t::GtdDlBitrate 


Guaranteed bit rate for downlink. 


7.18.2.11 іш NetPdpQosUmts t::DlvryOrder 


Delivery Order. 


7.18.2.12 int NetPdpQosUmts t::MaxSduSize 


Maximum SDU(Service Data Unit ) Size. 


7.18.2.13 іш NetPdpQosUmts t::SduErr 


SDU Error Ratio. 


7.18.2.14 int NetPdpQosUmts t::ResBitErr 


Residual BER(Bit Error). 


7.18.2.15 int NetPdpQosUmts t::DlvrErrSdu 


Delivery of erroneous SDU. 


7.18.2.16 int NetPdpQosUmts t::TransDelay 


Transfer Delay. 


7.18.2.17 int NetPdpQosUmts t::ThandlePrio 


Traffic Handling Priority. 


The documentation for this struct was generated from the following file: 


* PMIntf.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


7.19 NetPdpResumeIndEvInfo Struct Reference 


71 


7.19  NetPdpResumeIndEvInfo Struct Reference 


7.19.1 Detailed Description 


Connect Resume Indication event data. 


Data Fields 


e unsigned int ConnId 


Connection Identifier. 


* int Reason 


reason for connection resume 


7.19.2 Field Documentation 
7.19.2.1 unsigned int NetPdpResumeIndEvInfo::ConnId 


Connection Identifier. 


7.19.2.2 int NetPdpResumeIndE vInfo:: Reason 


reason for connection resume 


The documentation for this struct was generated from the following file: 


* Transport3GIntf.h 
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7.200 NetPdpSuspendIndEvInfo Struct Reference 


7.20.1 Detailed Description 


Connect Suspend Indication event data. 


Data Fields 


e unsigned int ConnId 


Connection Identifier. 


* int Reason 


reason for connection suspend 


7.20.2 Field Documentation 
7.20.2.1 unsigned int NetPdpSuspendIndEvInfo::ConnId 


Connection Identifier. 


7.20.2.2 int NetPdpSuspendIndEvInfo::Reason 


reason for connection suspend 


The documentation for this struct was generated from the following file: 


* Transport3GIntf.h 
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7.21  NetPdpTransportEventInfo t Union Reference 
7.21.1 Detailed Description 


Connection Event Info. 


Data Fields 


* NetPdpConnectRspEvInfo ConnectRsp 
PDP Connection Open Response Event Info. 


NetPdpDisConnectRspEvInfo DisconnectRsp 
PDP Connection Close Response Event Info. 


NetPdpDisConnectIndEvInfo DisconnectInd 
PDP Connection Close Indication Event Info. 


NetPdpResumeIndEvInfo ResumeInd 


PDP Connection Resume Indication Event Info. 


NetPdpSuspendIndEvInfo SuspendInd 
PDP Connection Suspend Indication Event Info. 


NetPdpTunnelEvInfo TunnelEventInfo 


Tunnel Response/Indication Event Info. 


7.21.2 Field Documentation 
7.21.2.1 NetPdpConnectRspEvInfo NetPdpTransportEventInfo t::ConnectRsp 


PDP Connection Open Response Event Info. 


7.21.2.2 NetPdpDisConnectRspEvInfo NetPdpTransportEventInfo t::DisconnectRsp 


PDP Connection Close Response Event Info. 


7.21.2.3 NetPdpDisConnectIndEvInfo NetPdpTransportEventInfo t::DisconnectInd 


PDP Connection Close Indication Event Info. 


7.21.2.4 NetPdpResumeIndEvInfo NetPdpTransportEventInfo t::ResumeInd 


PDP Connection Resume Indication Event Info. 


7.21.2.5 NetPdpSuspendIndEvInfo NetPdpTransportEventInfo t::SuspendInd 


PDP Connection Suspend Indication Event Info. 
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7.21.2.6 NetPdpTunnelEvInfo NetPdpTransportEventInfo_t::TunnelEventInfo 


Tunnel Response/Indication Event Info. 


The documentation for this union was generated from the following file: 


* Transport3GIntf.h 
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7.22 NetPdpTunnelEvInfo Struct Reference 


7.22.1 Detailed Description 


Tunnel Response Event Info. 


Data Fields 


• int ReqId 


Request Id of tunnel Response 
Transport Plug-in will return the same request ID which was used for calling the NetPdpTunnelRequest() 
It should be invalid for unsolicited tunnel response 


* int Datalength 
Data Length of Tunnel Response/Indication. 


* void х Data 


Tunnel Response Data/Indication. 


7.22.2 Field Documentation 
7.22.2.1 int NetPdpTunnelEvInfo::ReqId 


Request Id of tunnel Response 
Transport Plug-in will return the same request ID which was used for calling the NetPdpTunnelRequest() 


It should be invalid for unsolicited tunnel response 


7.22.2.) int NetPdpTunnelEvInfo::Datalength 


Data Length of Tunnel Response/Indication. 


7.22.2.3 void» NetPdpTunnelEvInfo::Data 


Tunnel Response Data/Indication. 


The documentation for this struct was generated from the following file: 


* Transport3GIntf.h 
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7.23 NetProfile t Struct Reference 


7.231 Detailed Description 


Profile data structures: Used between CM and PM Plug-in Interface. 


Data Fields 


* int ProfileId 
Profile ID of the profile. 


* NetProfileType t ProfileType 
Profile Type of the profile. 


* ProfileInfo t ProfileInfo 
Profile Information of profile. 


7.23.2 Field Documentation 
7.23.2.1 int NetProfile t::Profileld 


Profile ID of the profile. 


7.23.2.2  NetProfileType t NetProfile_t::ProfileType 


Profile Type of the profile. 


7.23.2.3 ProfileInfo_t NetProfile t::ProfileInfo 


Profile Information of profile. 


The documentation for this struct was generated from the following 


* PMIntf.h 


file: 
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7.24 NetWlanConnectRspEvInfo Struct Reference 


7.24.1 Detailed Description 


Connect Response event data. 


Data Fields 


e unsigned int ConnId 


Connection Identifier. 


* int Status 
Status value of connection Response indication. 
* NetWlanConnectRspInfo t ConnectRspInfo 
This will be typecast either to connInfo or reason, based on Status 
Status is NET CM SUCCESS then connectRspInfo will be typecast to connInfo, which contain the connec- 


tion info 
Otherwise connecRspInfo will be mapped to reason which informs that exact reason for connection failure 


7.24.2 Field Documentation 
7.24.21 unsigned int NetWlanConnectRspEvInfo::ConnId 


Connection Identifier. 


7.24.2.2 int NetWlanConnectRspEvInfo::Status 


Status value of connection Response indication. 


7.24.2.3 NetWlanConnectRspInfo t NetWlanConnectRspEvInfo:: ConnectRspInfo 


This will be typecast either to connInfo or reason, based on Status 


Status is NET CM, SUCCESS then connectRspInfo will be typecast to connInfo, which contain the con- 
nection info 


Otherwise connecRspInfo will be mapped to reason which informs that exact reason for connection failure 


The documentation for this struct was generated from the following file: 


• TransportWlanIntf.h 
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7.25  NetWlanConnectRspInfo t Union Reference 


7.25.1 Detailed Description 


Connect Response event data. 


Data Fields 


* NetWlanConnInfo t ConnInfo 


Connection Info. 


* int Reason 


Reason Code for failure. 


7.25.2 Field Documentation 
7.25.21 NetWlanConnInfo t NetWlanConnectRspInfo t::ConnInfo 


Connection Info. 


7.25.2.2 int NetWlanConnectRspInfo t::Reason 


Reason Code for failure. 


The documentation for this union was generated from the following file: 


• TransportWlanIntf.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


7.26 NetWlanConnInfo t Struct Reference 


79 


7.26 NetWlanConnInfo t Struct Reference 
7.26.1 Detailed Description 


Transport Error Cause. 


Data Fields 


e unsigned int ConnId 
WLAN Connection identifier. 


int DnsCount 
No of valid DNS address. 


char DevName [NET DEVICE NAME LEN MAX] 


Device name created for this connection. 


NetAddr t DnsAddr [NET ОМЅ ADDR MAX] 
DNS Addresses for this connection. 


NetAddr t IpAddr 


IP Address for this connection. 


boolean BNetmask 


Whether subnet mask present or not. 


NetAddr t SubnetMask 


Subnet mask. 


boolean BDefGateway 


Whether gateway address present or not. 


NetAddr t GatewayAddr 


Gateway address. 


7.26.2 Field Documentation 
7.26.2.1 unsigned int NetWlanConnInfo_t::ConnId 


WLAN Connection identifier. 


7.26.2. int NetWlanConnInfo_t::DnsCount 


No of valid DNS address. 


7.26.2.3 char NetWlanConnInfo t::DevName[NET DEVICE NAME LEN MAX] 


Device name created for this connection. 
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7.26.2.4 NetAddr t NetWlanConnInfo t::DnsAddr[NET DNS ADDR МАХ] 


DNS Addresses for this connection. 


7.26.2.5 NetAddr t NetWlanConnInfo t::IpAddr 


IP Address for this connection. 


7.26.2.6 boolean NetWlanConnInfo_t::BNetmask 


Whether subnet mask present or not. 


7.26.27 NetAddr t NetWlanConnInfo_t::SubnetMask 


Subnet mask. 


7.26.2.8 boolean NetWlanConnInfo_t::BDefGateway 


Whether gateway address present or not. 


7.26.2.9 NetAddr_t NetWlanConnInfo_t::GatewayAddr 


Gateway address. 


The documentation for this struct was generated from the following file: 


• TransportWlanIntf.h 
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7.237 NetWlanDisConnectIndEvInfo Struct Reference 


7.27.1 Detailed Description 


Connect Close Indication event data. 


Data Fields 


e unsigned int ConnId 


Connection Identifier. 


* int Reason 


reason for connection termination 


7.27.2 Field Documentation 
7.27.21 unsigned int NetWlanDisConnectIndEvInfo::ConnId 


Connection Identifier. 


7.27.2.2 int NetWlanDisConnectIndEvInfo::Reason 


reason for connection termination 


The documentation for this struct was generated from the following file: 


e TransportWlanIntf.h 
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7.28  NetWlanDisConnectRspEvInfo Struct Reference 


7.28.1 Detailed Description 


Connect Close Response event data. 


Data Fields 


e unsigned int ConnId 


Connection Identifier. 


* int Status 


Status value of connection Response indication. 


* int Reason 
This will contain the reason if Status is NET CM FAILURE. 


7.28.2 Field Documentation 
7.28.21 unsigned int NetWlanDisConnectRspEvInfo::ConnId 


Connection Identifier. 


7.28.2.2 int NetWlanDisConnectRspEvInfo::Status 


Status value of connection Response indication. 


7.28.2.3 int NetWlanDisConnectRspEvInfo:: Reason 


This will contain the reason if Status is NET CM. FAILURE. 


The documentation for this struct was generated from the following file: 


• TransportWlanIntf.h 
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7.29 NetWlanEventInfo t Struct Reference 


7.29.1 Detailed Description 


WLAN Transport Event Info. 


Data Fields 


* NetWlanTransportEvent_t EventId 
WLAN Asynchronous Event ID. 


* NetWlanTransportEventInfo t EventInfo 
WLAN Event Information. 


7.29.2 Field Documentation 
7.29.2.1 NetWlanTransportEvent t NetWlanEventInfo t::EventId 


WLAN Asynchronous Event ID. 


7.29.2.) NetWlanTransportEventInfo t NetWlanEventInfo t::EventInfo 


WLAN Event Information. 


The documentation for this struct was generated from the following file: 


• TransportWlanIntf.h 
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7.30 NetWlanProfileInfo t Struct Reference 


7.30.1 Detailed Description 


WLAN Profile Profile Information. 


Data Fields 


* NetBssInfo_t BssInfo 
BSS Information. 


e boolean BStaticIpAddr 
Static or Dynamic IP Address. 


* NetAddr t IpAddr 
IP address. 


* boolean BStaticDnsAddr 
Static or Dynamic DNS Address. 


* int DnsCount 
No of DNS Addresses. 


• NetAddr t DnsAddr [МЕТ DNS ADDR, MAX] 
DNS Addresses. 


7.30.2 Field Documentation 
7.30.2.1  NetBssInfo t NetWlanProfileInfo t::BssInfo 


BSS Information. 


7.30.2.2 boolean NetWlanProfileInfo_t::BStaticIpAddr 


Static or Dynamic IP Address. 


7.30.2.3 NetAddr_t NetWlanProfileInfo t::IpAddr 


IP address. 


7.30.2.4 boolean NetWlanProfileInfo t::BStaticDnsAddr 


Static or Dynamic DNS Address. 


7.30.2.5 int NetWlanProfileInfo_t::DnsCount 


No of DNS Addresses. 
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7.30.2.6 NetAddr_t NetWlanProfileInfo t::DnsAddr[NET DNS ADDR MAX] 


DNS Addresses. 


The documentation for this struct was generated from the following file: 


* PMIntf.h 
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7.34 NetWlanTransportEventInfo t Union Reference 


7.31.4 Detailed Description 


Connection Event Info. 


Data Fields 


* NetWlanConnectRspEvInfo ConnectRsp 
WLAN Connection Open Response Event Info. 


* NetWlanDisConnectRspEvInfo DisconnectRsp 
WLAN Connection Close Response Event Info. 


* NetWlanDisConnectIndEvInfo DisconnectInd 
WLAN Connection Close Indication Event Info. 


* NetWlanTunnelEvInfo TunnelEventInfo 


Tunnel Response/Indication Event Info. 


7.31.2 Field Documentation 
7.31.21 NetWlanConnectRspEvInfo NetWlanTransportEventInfo_t::ConnectRsp 


WLAN Connection Open Response Event Info. 


7.31.2.» NetWlanDisConnectRspEvInfo NetWlanTransportEventInfo t::DisconnectRsp 


WLAN Connection Close Response Event Info. 


7.31.2.3 NetWlanDisConnectIndEvInfo NetWlanTransportEventInfo t::DisconnectInd 


WLAN Connection Close Indication Event Info. 


7.31.2.4 NetWlanTunnelEvInfo NetWlan TransportEventInfo t::TunnelEventInfo 


Tunnel Response/Indication Event Info. 


The documentation for this union was generated from the following file: 


* TransportWlanIntf.h 
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7.32  NetWlanTunnelEvInfo Struct Reference 


7.32.1 Detailed Description 


Tunnel Response Event Info. 


Data Fields 


• int ReqId 


Request Id of tunnel Response 
Transport Plug-in will return the same request ID which was used for calling the NetWlanTunnelRequest() 
It should be invalid for unsolicited tunnel response 


* int Datalength 
Data Length of Tunnel Response/Indication. 


* void х Data 


Tunnel Response Data/Indication. 


7.32.2 Field Documentation 
7.32.2.1 int NetWlanTunnelEvInfo::ReqId 


Request Id of tunnel Response 
Transport Plug-in will return the same request ID which was used for calling the NetWlanTunnelRequest() 


It should be invalid for unsolicited tunnel response 


7.32.2.) int NetWlanTunnelEvInfo::Datalength 


Data Length of Tunnel Response/Indication. 


7.32.2.3  void« NetWlanTunnelEvInfo::Data 


Tunnel Response Data/Indication. 


The documentation for this struct was generated from the following file: 


• TransportWlanIntf.h 
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7.33 ProfileInfo_t Union Reference 


7.331 Detailed Description 


Profile information : Union of PDP and WLAN profile information. 


Data Fields 


* NetPdpProfileInfo t Pdp 
PDP Profile Information. 


* NetWlanProfileInfo t Wlan 
WLAN Profile Information. 


7.33.22 Field Documentation 
7.33.2.1  NetPdpProfileInfo t ProfileInfo t::Pdp 


PDP Profile Information. 


7.33.2.2 NetWlanProfileInfo t ProfileInfo t::Wlan 


WLAN Profile Information. 


The documentation for this union was generated from the following file: 


* PMIntf.h 
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7.34 0ов t Union Reference 


7.34.4 Detailed Description 


Union of different type of Qos Info. 


Data Fields 


* NetPdpQosGprs t QosGprs 
GPRS QOS parameters. 


* NetPdpQosUmts t QosUmts 
UMTS (WCDMA) QOS parameters. 


7.34.2 Field Documentation 
7.34.2.1  NetPdpQosGprs t Qos t::QosGprs 


GPRS QOS parameters. 


7.34.2.  NetPdpQosUmts t Qos t::QosUmts 


UMTS (WCDMA) QOS parameters. 


The documentation for this union was generated from the following file: 


* PMIntf.h 
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Chapter 8 


File Documentation 


8.1 ComponentOverview.h File Reference 


8.1.1 Detailed Description 


Component Programming Interface Overview Header Template for Doxygen. 


This file contains configuration information for documentation generation; it does not contain any API- 
specific information. 
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8.2 NetCMConfig.h File Reference 


8.2.1 Detailed Description 


This file describes vendor specific configurable constants of CM Module. 


Defines 


* #define NET CONNECTIONS MAX NET CONNECTIONS MAX VENDOR DEFINED 


Maximum Number of Connections that can be established simultaneously-It is Vendor specific value. 


* #define NET DEVICE NAME LEN MAX МЕТ DEVICE NAME LEN MAX VENDOR - 
DEFINED 


Maximum length of device name that will be created after a successful connection establishment-It is Vendor 
specific value. 


* #define NET DNS ADDR. MAX NET DNS ADDR MAX VENDOR DEFINED 
MAX number of DNS Address-It is Vendor specific value. 
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8.3 NetCMError.h File Reference 


8.3.1 Detailed Description 


This file defines the common error code. 


Enumerations 


• enum NetErr t ( 


NET ERR NONE = 0x00, NET ERR UNKNOWN , NET ERR APP ALREADY - 
REGISTERED, NET ERR. APP REGISTRATION FAILED, 


NET ERR APP MAX CLIENT REGISTERED, NET ERR INVALID CLIENT, NET ERR - 
INVALID PROFILEID, NET ERR. NO ACTIVE CONNECTIONS, 


NET ERR ACTIVE CONNECTION EXISTS, NET ERR CONNECTION KILLING, NET - 
ERR. CONNECTION OPENING, NET ERR. CONNECTION CLOSING, 


NET ERR MAX CONNECTIONS, NET ERR MAX CLIENTS PER CONNECTION, NET - 
ERR MAX CONNECTION КІШ, КЕО, NET ERR MAX TUNNEL REQ, 


NET ERR ACCESS DENIED, NET ERR INVALID PARAM, NET ERR INVALID - 
OPERATION, NET ERR. TRANSPORT, 


NET ERR CONNECTION KILLED } 


Error Defination. 
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8.4 NetCMIntf.h File Reference 


8.4.1 Detailed Description 


This file defines the interface of Connection Manager with the application. 


Data Structures 


* struct NetEventInfo t 


Event Info with Event on callback from Connection Manager. 


* struct NetEventTunnelIndInfo t 


Event Info with Event on Indication from Connection Manager. 


* struct NetDevInfo t 


Device Info in Connect response event. 


* struct NetCMTunnelInfo t 


Tunnel data: Used in sending tunnel request to Connection Manager. 


Typedefs 


e typedef void(« NetAppEvtCb t )(const NetEventInfo t *NetEvent) 


callback function: used to notify client application about Asynchronous events. 


Enumerations 


• enum NetEvent t ( 


NET EVENT OPEN RSP, NET EVENT CLOSE RSP, NET EVENT KILL RSP, NET - 
EVENT CLOSE IND, 


NET EVENT SUSPEND IND, NET EVENT RESUME IND, NET EVENT TUNNEL RSP, 
NET EVENT TUNNEL IND } 


Callback Event. 


e enum NetTransportType t { NET. TRANSPORT. TYPE РОР, NET TRANSPORT TYPE - 
WLAN } 


Transport Type. 


Functions 


* int NetCMClientRegister (NetAppEvtCb t EventCb) 
This API shall register the client application with the CM server. 


* int NetCMClientDeRegister () 


This API will deregister the client application with the CM server. 
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• int NetCMConnectionOpen (int ProfileId[ |, int ProfileCount) 


This API will establish a data connection for the first entry in the array Profileld. 


* int NetCMConnectionClose (int ProfileId) 
This API will terminate the connection referred by the Profileld. 


• int NetCMDeviceGetInfo (int ProfileId, NetDevInfo t *DevInfo) 


This API shall get the device information associated with the connection referred by the Profileld. 


* int NetCMGetActiveProfileIDs (int ProfileId[ ], int «ProfileCount) 
This API will retrieve all active profile IDs. 


e int NetCMGetTransportError (int *Error) 


This API returns transport specific error cause for the synchronous return of the last initiated API request. 


* int NetCMConnectionKill (int ProfileId) 
This API shall kill active connection referred by the Profileld. 


• int NetCMTunnelRequest (NetCM TunnelInfo t «TunnelData) 


This API will be used to send any transport specific proprietary information to transport plug-in. 
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8.5 NetCMTransportIntf.h File Reference 


8.5.1 Detailed Description 


Interface File describing CM Constants. 


Defines 


* #define NET СМ FAILURE -1 
Value of Constant FAILURE. 


* #define NET CM, SUCCESS 0 
Value of Constant SUCCESS. 


* #define NET СМ INVALID ID -1 
Invalid Request ID. 
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8.6 PMIntf.h File Reference 


8.6.1 Detailed Description 


This file defines the interface of Profile Manager with the application/Connection Manager. 


Data Structures 


* union IpAddr t 
IP Address. 


* struct NetPdpQosGprs t 
PDP GPRS Qos Information. 


* struct NetPdpQosUmts t 
PDP UMTS(3G) Qos Information. 


* union Qos t 


Union of different type of Qos Info. 


* struct NetAddr t 


Network Address information. 


e struct NetPdpQoslInfo t 


PDP Qos Information. 


* struct NetAuthInfo t 


PDP Authentication Information. 


* struct NetPdpProfileInfo t 


PDP Profile Profile Information. 


* struct NetBssInfo t 


BSS Information. 


* struct NetWlanProfileInfo t 


WLAN Profile Profile Information. 


* union ProfileInfo t 


Profile information : Union of PDP and WLAN profile information. 


* struct NetProfile t 


Profile data structures: Used between CM and PM Plug-in Interface. 
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Defines 


* #define NET РОР АСТН USERNAME LEN MAX 32 


Maximum length of username in PDP profile. 


• #define NET РОР AUTH, PASSWORD LEN MAX 32 
Maximum length of password in PDP profile (used in authentication parameters) [3GPP Defined variable]. 


* #define NET РОР АРМ LEN MAX 255 
Maximum length of APN in PDP profile [3GPP Defined variable]. 


Enumerations 


enum NetProfileType t ( NET PROFILE TYPE PDP, NET PROFILE TYPE WLAN, NET - 
PROFILE TYPE ALL ] 


Profile Type. 


enum NetAddrType t ( NET ADDR IPVA = 0x0, NET ADDR IPV6 = 0х1 } 
Address Type. 


enum NetAuthType t ( NET РОР AUTH. NONE = 0x0, NET РОР AUTH PAP = 0х1, NET - 
РОР AUTH CHAP = 0x2] 


PDP Authentication Type. 


enum NetPdpQosType t ( NET РОР QOS GPRS, NET РОР 005 UMTS } 
PDP Qos Type. 


enum NetBssType t { NET EVENT WLAN BSSTYPE INFRA, NET EVENT WLAN - 
BSSTYPE ADHOC, NET EVENT WLAN BSSTYPE BOTH ) 


BSS Information. 


Functions 


• int NetPMGetProfile (int ProfileId, NetProfile t Profile) 
This plug-in API should return the profile information referred by Profileld. 


• int NetPMGetDefaultProfileld (int «ProfileId) 
This plug-in API should return the default profile Id for CM. 
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8.7 Transport3GIntf.h File Reference 


8.7.1 Detailed Description 


PDP Transport Interface. 


Data Structures 


e struct NetPdpConniInfo t 


Transport Error Cause. 


e union NetPDPConnectRspInfo t 


Connect Response event data. 


* struct NetPdpConnectRspEvInfo 


Connect Response event data. 


* struct NetPdpDisConnectRspEvInfo 


Connect Close Response event data. 


* struct NetPdpDisConnectIndEvInfo 


Connect Close Indication event data. 


* struct NetPdpSuspendIndEvInfo 


Connect Suspend Indication event data. 


* struct NetPdpResumeIndEvInfo 


Connect Resume Indication event data. 


* struct NetPdpTunnelEvInfo 


Tunnel Response Event Info. 


* union NetPdpTransportEventInfo t 


Connection Event Info. 


* struct NetPdpEventInfo t 
PDP Transport Event Info. 


Typedefs 


e typedef void(* NetPdpEvtCb )(const NetPdpEventInfo t «NetPdpEvent) 


Callback function Connection Manager needs to register a callback function with PDP transport plug-in to 
receive asynchronous events 
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Enumerations 


enum NetPdpTransportEvent t { 


NET EVENT PDP ACTIVATION RSP, NET EVENT PDP DEACTIVATION RSP, NET - 
EVENT PDP DEACTIVATION IND, NET EVENT PDP SUSPEND IND, 


NET EVENT PDP RESUME IND, NET EVENT PDP TUNNEL } 
PDP Transport Asynchronous Event Type. 


Functions 


int NetPDPInit (NetPdpEvtCb PdpEventCb, int *ReasonCode) 


This API shall initialize PDP Transport plug-in interface for CM 
PdpEventCb is the callback function that Connection Manager will register with PDP Transport Plug-in 
interface to receive PDP Transport events. 


int NetPDPOpenConnection (unsigned int Connld, int Profileld, int «ReasonCode) 


This API shall bring up PDP connection with the profile information passed in profile parameter 
Connection Manager will use Connld passed in this API to Abort/Close the connection later 


int NetPDPCloseConnection (unsigned int ConnId, int *ReasonCode) 


This API shall tear down PDP connection 
CM shall use this API to abort an on-going PDP Activation procedure. 


int NetPdpDelnit (void) 
This API de-initializes the PDP Transport plug-in Interface for CM. 


int NetPdpTunnelRequest (int Кеда, int DataLength, void «Data) 
This API will send the tunnel request to PDP transport Plug-in interface. 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


8.8 TransportWlanIntf.h File Reference 101 


8.8 TransportWlanIntf.h File Reference 


8.8.1 Detailed Description 


WLAN Transport Interface. 


Data Structures 


* struct NetWlanConnInfo t 


Transport Error Cause. 


union NetWlanConnectRspInfo t 


Connect Response event data. 


struct NetWlanConnectRspEvInfo 


Connect Response event data. 


struct NetWlanDisConnectRspEvInfo 


Connect Close Response event data. 


struct NetWlanDisConnectIndEvInfo 


Connect Close Indication event data. 


struct NetWlanTunnelEvInfo 


Tunnel Response Event Info. 


union NetWlanTransportEventInfo t 


Connection Event Info. 


struct NetWlanEventInfo t 
WLAN Transport Event Info. 


Typedefs 


e typedef void(« NetWlanEvtCb )(const NetWlanEventInfo_t «NetW]anEvent) 


Callback function Connection Manager needs to register a callback function with WLAN transport plug-in 
to receive asynchronous events 


Enumerations 


e enum NetWlanTransportEvent t ( NET EVENT WLAN CONNECTION RSP, NET EVENT - 
WLAN DISCONNECTION RSP, МЕТ EVENT WLAN. DISCONNECTION IND, МЕТ - 
EVENT WLAN TUNNEL } 


WLAN Transport Asynchronous Event Type. 
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Functions 


* int NetWlanInit (NetWlanEvtCb WlanEventCb, int «ReasonCode) 
This API shall initialize WLAN Transport plug-in interface for CM. 


• int NetWlanOpenConnection (unsigned int Connld, int Profileld, int «ReasonCode) 


This API shall bring up WLAN connection with the profile information passed in profile parameter 
Connection Manager will use Connld passed in this API to Abort/Close the connection later 


e int NetWlanCloseConnection (unsigned int ConnId, int «ReasonCode) 


This API shall tear down WLAN connection 
CM shall use this API to abort an on-going WLAN connection procedure. 


* int NetWlanDelnit (void) 
This API de-initializes the WLAN Transport plug-in Interface for CM. 


• int NetWlanTunnelRequest (int ReqId, int DataLength, void Data) 
This API will send the tunnel request to WLAN transport Plug-in interface. 
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9.1 Framework API 


9.1.1 Connection Manager Framework АРІ 


The following lists summarize the Connection Manager Framework APIs and their intended usage. This 


section includes 


interaction API with Profile Manager Plug-in and Transport plug-in interface APIs. For 


Transport Plug-in, API document is only capturing PDP and WLAN Transport Plug-in interface. 


CM - PM Plug-in APIs 


1. NetPMGetProfile 


2. NetPMGetDefaultProfileId 


CM - PDP Transport Plug-in APIs 


л о WN н 


. NetPDPInit 

. NetPDPOpenConnection 
. NetPDPCloseConnection 
. NetPdpDeInit 


. NetPdpTunnelRequest 


CM - WLAN Transport Plug-in API 


NetW 


NetWl 


NetWl 
NetWl 


Татлтта 


anOpenConnection 
anCloseConnection 


anDeInit 


1. 
2. 
3. NetW1 
4. 
5. 


anTunnelRequest 


9.1.1.1 Transport Plug-in Callback Ids 


The lists below summarize the Callback Ids returned by registered CM callback functions used by the PDP 
and WLAN Transport Plug-in interfaces. 
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PDP Callback Ids 
1. NET EVENT PDP ACTIVATION RSP 
2. NET EVENT. РРР DEACTIVATION RSP 
3. МЕТ EVENT. PDP DEACTIVATION IND 
4. NET. EVENT PDP SUSPEND IND 
5. NET. EVENT PDP RESUME IND 
6. NET EVENT PDP TUNNEL 

WLAN Callback Ids 
1. NET EVENT WLAN CONNECTION RSP 
2. NET EVENT WLAN DISCONNECTION RSP 
3. NET EVENT WLAN DISCONNECTION IND 
4. N EVENT WLAN TUNNEL 


9.1.1.2 DataType Definitions 


Error Values 


NetErr. t (Error values) 


Callback Event Data Structures 


1. NetEvent t (Net Event type) 


2. NetEvent Info_t (NET Event Information) 


3. NetDevInfo_t (NET Device Information) 


Profile Data Structures 


1. NetProfileType t (NET Profile Type) 


. NetPdpProfileInfo t (NET PDP Profile Information) 


. NetWlanProfileInfo t (NET WLAN Profile Info) 


. NetBssInfo t (NET WLAN BSS Info) 


Address Data Structures 


2 
3 
4. NetProfile t (NET Profile) 
5 
6 


. NetBssType t (NET BSS type) 


supported. IPv6 may be supported in future releases. 


1. NetAddrType t (NET Address Type ) 


2. NetAddr. t (NET Address) 


NET CM API Data Structures 


l. NetTransportType t (NET Transport type) 


2. NetCMTunnelInfo, t (NET Tunnel Info) 


In LiMo Foundation Platform Release 1, only IPv4 address type shall be 
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NET Authentication Data Structures 


1. NetAuthType t (NET Authentication Type) 


2. NetAuthInfo_t (NET Authentication Information) 


QOS Data Stuctures 


1. NetPdpQosType_t (NET PDP QOS Туре) 
2. NetPdpQosGprs_t (NET PDP GPRS QOS Type) 
3. NetPdpQosUmt s_t (МЕТ PDP 3G QOS Туре) 


4. Net PdpQosInfo_t (МЕТ PDP QoS information) 


Data Constants 


CM Defined 


NET_CM_FAILURE 
NET_CM_SUCCESS 
NET_CM_INVALID_ID 


Other Defined Constants 


2 


DEVICE NAME LEN MAX 
. CONNECTIONS МАХ 

PDP APN LEN MAX 

.PDP AUTH USERNAME LEN МАХ 
282. 

. D 


DP AUTH PASSWORD LEN MAX 
NS ADDR MAX 


42222424 
Е 


9.1.1.3 Connection Manager to Profile Manager Plug-in АРІ 


This section describes the Profile Manager Plug-in APIs that shall be used by Connection Manager. 


1. NetPMGetProfile 


2. NetPMGetDefaultProfileId 


9.1.1.4 Connection Manager to PDP Transport Plug-in АРІ 


1. NetPDPInit 
2. NetPDPOpenConnection 
3. NetPDPCloseConnection 


4. NetPdpDeInit 


5. NetPdpTunnelRequest 
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PDP Callback Specification (PDP Transport Plug-in to CM) Connection Manager needs to register a 
callback function with PDP transport plug-in to receive asynchronous events. This section describes the 
callback function which will be used to notify the Connection manager about the PDP Transport Plug-in 
Asynchronous events. 


Net 


PdpEyvtob 


Plug-in will allocate the memory for event data. Once Context returns from callback then plug-in will free 
the memory allocated to event data. 


PDP Asynchronous Events 


NetPdpTransportEvent t 


Events are: 
1. МЕТ EVENT PDP ACTIVATION КӘР 
2. МЕТ EVENT, PDP. DEACTIVATION КӨР 
3. МЕТ EVENT. PDP. DEACTIVATION, IND 
4. NET. EVENT. PDP. SUSPEND IND 
5. NET EVENT, PDP RESUME IND 
6. NET EVENT PDP TUNNEL 


PDP Connection Information 


NetPdpConnInfo t 


9.1.1.5 Connection Manager to WLAN Transport Plug-in АРІ 


1; 


2. 


3. 


NetWla 


NetWla 


NetWla 


NetWla 


NetWla 


nuit 
nOpenConnection 
nCloseConnection 
nDeInit 


nTunnelRequest 


WLAN Callback Event Sata Structures 


WLAN Callback Specification (WLAN Transport Plug-in to CM) 


Connection Manager needs to register a callback function with WLAN transport plug-in to receive 
asynchronous WLAN events. This section describes the callback function which will be used to notify 
the Connection manager about the WLAN Transport Plug-in Asynchronous events. 


NetWlanl 


ЕУЕСІ 


The Plug-in will allocate the memory for event data. Once Context returns from callback then plug-in 
will free the memory allocated to event data. 
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WLAN Asynchronous Events NetWlanTransportEvent t 


Events are: 


1. NET_EVENT_WLAN_CONNECTION_RSP 


2. NET_EVENT_WLAN_DISCONNECTION_RSP 


3. NET_EVENT_WLAN_DISCONNECTION_IND 


4. NET_EVENT_WLAN_TUNNEL 


WLAN Plug-in Device Information NetWlanConnInfo t 
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9.2 Call Flow Diagrams 


9.2.1 DNET CM Call Flow Diagrams 


9.2.1.1 PS Data Connection Establishment and Disconnection procedure 


PS Data call Establishment and Disconnection procedure 


NetC MC lientRegister() 


Success/F ailurereturn 


OR ER 6 ЕТЕ бе иене в 


Е 


МЕТ. EVENT, OPEN. RSP 


Data Transfer 
using Socket, 
Http, ete 


NetC MC onnedionClose(P rofile Id) 


Request sent Success/F ailurereturn 


NET. EVENT. CLOSE. БЕР 


Connedion 


Manager 


CM send comection establishment request to the 
corresponding transport plugin interface. 


Note CM will initiate a new connection onlyif there is no 
active call exist for the given profile ID . 


Transport Device sends the connection establishment 
response to CM. After processing, CM send 
МЕТ. EVENT, OPEN. БЕР event to App. 


CM send connedion Close reques to the corresponding 
transport plug-in interface. 


Мае: CM will sendthe close connection request only when 
no other application is using the connection . 


Transport Device sends the connection Close response to 
CM. After processing, CM send NET EVENT, CLOSE RSP 
evert to App. 


Figure 9.1: PS Data Connection Establishment and Disconnection Procedure 
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9.2.1.2 Aborting a Connection Establishment Procedure 


Aborting a connection establishment procedure 


is Connedion 
үнде ыы 


NetCMConnectionOpen(Profile Id) 
--------------------------» 


СМ send connection establishment request to the 
corresponding transport plug-in interface. 


Request sert: Success /Failure-return 


Note: CM will initiate a new connection only if there is no 
active call exist for the gven profile ID. 


f Application wants to abort 
the connection, then 
application can call 
NetCMConnedionClose()to 
abort the connection 


CM send connection Close request to the corresponding 


transport plug-in interface. 
NetCMConnedionCloseProíle Id) ent 
—ÓÓÓÓM—ÓMÓÀ Á Rie 


Request sert: Success/Failure-return 


Note CM ‘will send the close connection request only when 
no other application is using the connection. 


MET E VENT, CLOSE, RSP 
Transport Device sends the connection Close response to 
CM. After processing, CM send NET E VENT, CLOSE, RSP 


event to App. 


Figure 9.2: Aborting a Connection Establishment Procedure 
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9.2.1.3 Procedure to Select the Connection for Data Transfer 


Data Transfer: Procedure for selecting the connection 


Application oie Linux Socket 


N&eCMConnectionOpen(Profile Id) 


.Requestsert SuccessFeilure-retum —— 


When Connection established 
successfully, CM will send 
NET. EVENT, OPEN, КР event to 
application 


МЕТ EVENT. OPEN. ВЗР 


On successful connection, The 
event will contain connection 
relatedinfolp Addr, DNS Addr, 


Device МатефароАмапо), etc 


Sockfd = socket() 


setsockopt(Sockfd, SOL. SOCKET, SO. BINDTODEMCE , 'pdpt) 


SO BINDTODEMCE will bindthe socket 
with device "pdpO" created forthis 


connection. Device name sent on connect 
response vill be used in setsockopt() 


Figure 9.3: Procedure to Select the Connection for Data Transfer 
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9.2.1.4 PS Data Connection Suspend and Resume Procedure 


PS Data Call Suspend / Resume Procedure 


Application 


МесмСоппеснопОрег(Ргойе Id) 


Request sent: Success/F ailurereturn 


NET_EVENT_OPEN_RSP 


NET_EVENT_SUSPEND_IND 


NET_EVENT_RESUME_IND 


Connection 
Manager 


CM send connection 
establishment request to the 

corresponding transport ріменгі 
interface. 


Ahen Connection established 
successfully , CM aill send 
МЕТ EVENT, OPEN. RSP event to 
application 


Transport PlucHn Interface(PDP) sends 
data suspend indication to CM . 
After processing, CM ‘will send 

MET EVENT. SUSPEND IND Event to all 

application that uses this connection . 


Transport PlucHn Interface PDFP) sends 
data resume indication to CM. 


After processing, CM will send 
МЕТ EVENT. RESUME IND Event to all 
application that uses this connedion . 


Figure 9.4: PS Data Connection Suspend and Resume Procedure 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


112 Page Documentation 


9.2.1.5 Transport Plug-in Interface Init/De-init Sequence 


PDP Transport Wian Transport 
Plug-in Plug-in 


Мер dplnit() 
Boot Up 


ачып Return Success ailure 


Netlaninit() 


Return Success ailure 


Мар dpD elnit() 


Shut Down 
sequence 


Return Success 


NetlanDelnitQ) 
Return Success 
Note: 


1) CM will initiaize of each and every transport plug-in device interface at boot up tine. So 
that CM can receive unsolicited indication from different transport plug-in interface. 


2) If initialization of Transport plug-in Interface has failed during boot-up then CM will 
initialize only requested transport plug-in interface( Application has requested for opening 
connection for particular transport plug-in interface. 

3) At the shut down routine, CM will shutdown the Transport Plugin interface. 


Figure 9.5: Transport Plug-in Interface Init/De-init Sequence 
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9.2.1.6 Interaction with PDP Transport Plug-in (Single Connection) 


PDP Transport 
Plugin 


Application 


NetCMC оппеснопОрег(Ргойе Id) 


Connection 
Manager 
Based on profile type, CM will call 

corresponding Transport Plugin Interface. 


If Transport Plucdn is not initialized and CM 
has not register Callback function with 
Transport Plug-in then СМ aill call the 

initialize function . 


etP dplnit ( CbkCMfunc )——— ———* 


If Return failure then CM ‘will return error to Application 
Otherwise CM will Call Open connection АРІ CM pass 
Connld, profile Info. 

Transport Ріиснп can return success or failure . If API is failed 
then transport plug-in will return reason for failure. 


Mee Return Failure «nne 


etP dpOpenConnedion ()—— — — —» 


----Request sent: Success;F ailure- return : +++ ++ 


ET EVENT. PDP ACTIVATION, RSP 


MET EVENT OPEN КЕР 


NetCMC onnectionClose(P rofile Id) 


4----Кедиезі sent: Success ailure- returns... 
etP dpCloseC onnection (С onnl d)——» 


ET_EVENT_PDP_DEACTIVATION_RSP 
ET_EVENT_CLOSE_RSP 


Figure 9.6: Interaction with PDP Transport Plug-in (Single Connection) 
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9.2.1.7 Interaction with WLAN Transport Plug-in (Single Connection) 


Connedion Wlan Transport 
Manager Plug-in 
Based on profile type, CM ‘will call 

corresponding Transport Plugin Interface. 


If Transport Plugin is not initialized and CM 
has not register Callback function with 


Application 


NetCMConnectionOper(P rofile Id) 


Transport Plug-in then CM ‘will call the 
initialize function . 


etManlnit ( CbkCMfunc )—— — —» 


If Retum failure then CM will return error to Application 
Otherwise CM will Call Open connection АРІ CM pass 
Connid, profile Into. 

Transport Plugin can return success or failure . If API is failed 
then transport plug-in sill return reason for failure. 


eti^lanOpenConnedion ( 


ч..... Request sent: Success/F ailure-return- - - - - - - 


ET. EVENT 'WLAN. CONNECTION КЕР 
ET EVENT. OPEN. КЕР 


NetCMConnectionC loseP rofile Id) 


*«----Request sent: Success/F alure- return - - --- 
eti^tanCloseC onnedion (C onnld 


“...:--Кедмезі sent: Success F ailure-return- - - - - -- 


ET EVENT УЙ АМ DISCONNECTION КӘР 


MET EVENT CLOSE RSP 


Figure 9.7: Interaction with WLAN Transport Plug-in (Single Connection) 
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9.2.1.8 Interaction with PDP Transport Plug-in (Multiple Connections) 


PDP Transport 
Plug-in 


Күте Connedion 
сыы 
Based on profile type, CM ‘will call 
corresponding Transport Plugin Interface. 


If Transport PlucHn is not initialized and CM 
has not register Callback function with 
Transport Plug-in then CM ill call the 

initialize function . 


NetCMConnecionOper(Profile 141] 


etP dplnit ( CbkCM func )———— ———» 


-.---.-.-Кешіп Райи ................ 3 


----Request sent: Success;F ailure- return . . ... . 
MET EVENT. PDP. АСТІУАТІОМ RSP 
MET EVENT. OPEN, RSP 


NetCMComectionOper(Profile 142) 
etP dpOpenc onnedion (C onnld2)—— ——X». 


----Request sent: Success;F ailure- return- «---- 
MET EVENT. РОР АСТІУАТІОМ КӘР 


МЕТ. EVENT. OPEN, КЕР 


Application can use any ofthe two 
connected links for data transfer 
using data plane 


NetCMCornectionC lose(P rofle 101) 


*----Request sent: Success;F ailure- return : + +++ 
etP dpCloseC onnedion (С onnld1)————» 
-----4 Request sent: зиссезз/ allure-return: 6... 


ET EVENT. PDP. DEACTIVATION, КЕР 
ET EVENT CLOSE RSP 


NetCMConnedionClose(Profile 142) 


@----Request sent: SuccessF ailure- return . . . .. 
etP dpCloseC onnedion (Connld2)————» 


ET EVENT. PDP. DEACTIVATION, RSP 
NET EVENT. CLOSE БЕР 


Figure 9.8: Interaction with PDP Transport Plug-in (Multiple Connections) 
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9.2.1.9 Interaction with Mixed Transport Plug-in (Multiple Calls) 


PDP Transport 
Plug-in 


сан Connection Wlan Transport 
sea Дд 
NetCMConnectionOpen(Profil 191) Based on profile type, CM wil call 
corresponding Transport Plugin Interface. 


еїМЛапОрепС onne dion (ConnldT) ———* 


T Requestsent: Success/F ailure return- . s-s . - 4 
+> -Requestsent: Success/F ailure return - -- -,- 


NET EVENT WLAN CONNECTION АЗР шана 
NET EVENT, OPEN, КӘРІ 
NetCMC onnectionOper( Profile 192) 


Ме dp Op en C o nn ection (C onnl d2] 
1 


көбөт, i Request sent: Success F ailure returmi- nnn nnns 


eRequestsent: Success/F ailure return-.--+- 


МЕТ EVENT. PDP. ACTIVATION ЕР, 
NET. EVENT, OPEN. БӘР 


Application can use amy of 
the two connected links for 


data transfer on data plane 


NetCMConnectionC las &Profile Id 1) 
М 


--.-Кедиезізепі: Success/Failure return: 
М еййЛапС los eC onne dion (Connld 1)— —* 
2e Requestsent: Success/F ailure return- -- - -- - 4 
NET EVENT WLAN DISCONNECTION ЕР 


МЕТ EVENT CLOSE RSP 


NetCMConnectionC losg Profile 142) 
Ы— oA 


a.) -Requestsent: Success/Failure return.: 
Netifi/lan Close Connection (C o nnl d2)—————————————» 
1 


tene rn nnn nn nier Request sent: Success /F ailure return «n nn 
| 
МЕТ. EVENT PDP DEACTIVATION КР 
NET EVENT CLOSE RSP 


Figure 9.9: Interaction with Mixed Transport Plug-in (Multiple Calls) 
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9.2.1.10 Open Connection (Usage of Profile List) 


Plug-in 


Application 


NetCMConnedionOperfProfile Id List) 


Connedion 
Manager 


CM will read the first profile in the first and 
start processing on that Profile ID. 
Processing of other Profile ID is outside CM 
scope in R 1. 


Based on profile type, CM ill call 
corresponding Transport Plugin Interface. 


If Transport Ріиснп is not initialized and CM 
has not register Callback function with 
Transport Plug-in then CM will call the 

initialize function . 


etWanlnit ( CbkCM func )J—— —— ———» 


If Return failure then CM ‘will return error to Application 
Otherwise CM will Call Open connection АРІ CM pass 
Connld, profile Info. 

Transport PlucHn can return success or failure. If API is failed 
then transport plug-in will return reason for failure. 


etWlanOpenC onnedion ()-----» 


“- Request sent: Success;F ailure-return. - --- · - 


ET. EVENT WLAN, CONNECTION ВЗР 


ET EVENT WLAN. DISCONNECTION БЕР 


ET EVENT CLOSE RSP 


Figure 9.10: Open Connection (Usage of Profile List) 


Wlan Transport 
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9.2.1.11 Open Connection: Link Sharing 


NetCMC onnedionOper(Profile Id1 ) 


Connection PDP Transport 
Manager Plugin 
Based on profile type, CM vill call 

corresponding Transport Plugin Interface. 


If Transport Plugin is not intiakzed and CM 
hasna register Calback funcion with 
Transport Pluginthen CM wil call the 

iritiaize function . 


аР cplnit ( СКС Mfunc № 


Application 


ee Return F allure 


-. Request sent Sucess F alure- return. ... . 
ET EVENT. РОР. АСТІУАТІОМ КӘР 
ET EVENT, ОРЕМ КЕР 


месмсСопгесіспОрегіРгойіе Id) 


Open Requed is for the same profile id 
РОТЕ Request sent: Suocess/Failure- return: б, | Whichisalresdy opened. So Ink sharing wil 
happen. СМ will nd talk to Transport Device 
end reum OPEN RSP with Device по 


ET EVENT. ОРЕМ RSP inmedately. 


NetCMC onnedionClosefP rofle 10 ) Close Request is for the profile ici 
Connedion which is being shared between 


-Reques зегі: Success F ailure- retum - . ...] | different applications. So link will nct dose . 
CM vll not talk to Transport Device and 
return CLOSE КЕР immediately. 


ET EVENT. CLOSE КӘР 


NetCMConnedtionClasatP rofle 101) 


жыккан 5100 Request sent Suceess/Fallure- retur: 06007 

ePdpCloseC onnedion (Conni 
qs Request sent: Success/Failureretum. -+ 
ET EVENT РОР DEACTIVATION КЕР, 


ET EVENT CLOSE КӘР 


Figure 9.11: Open Connection: Link Sharing 
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9.2.1.12 Usage of АРІ: NetCMConnectionKill (in case of WLAN) 


Application 1 


N etWlanOpenC onnectiosi) 
Retum SUCCESS 


МЕТ EVENT WLAN CONNECT Е5Р 


N etW1anOpenC отпес о 


Depending upon transport 
plugin, It can retum success or 
enor. This is a failure case 


Retum FAILURE 


NetCMGetActiveProfileIDs 


Return ( Active ProfileIDs) 


NetCMC onnectionKill(pfl) 
Retum SUCCESS 


Net¥lanCloseC onnectiorj) 
$3 


Return SUCCESS 


P 


NET EV ENT C 105 E IND wj —Ó—Ó—M 


Figure 9.12: Usage of API: NetCMConnectionKill (in case of WLAN) 
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9.2.1.13 Tunnel Request and Response Sequence 


Application 


Лап Transport 
Plugin 


СМ will generate a request id and return 
request id to application. CM will send the 
request to transport plug-in using the 
same request id which will be used for 
mappingthe response to request. 


NetCM TunnelR equest) 


Neti^anT unnelRequest() 


Request sent: Success ailure 


Request sent: Success ailure 
If success then return the request id 


NET_EVENT_VVLAN_TUNNEL 


Response daa contains the request Id 
which has been passed during 
Neti^danTunnelRequest АРІ. It also 
МЕТ EVENT TUNNEL RSP contain the data and data length which 
needsto forwarded to application. 


Response data contains the request 
Id. It also containsthe data and data 
length This Indication will only be 
given tothe requested application. 


1) CM sill only works as router for tunnel АРІ. 
2) CM will not do any processing of request or response. 
3) Understanding of request isthe responsi ibility of Tarpon plugin interface 


Figure 9.13: Tunnel Request and Response Sequence 
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9.2.1.14 Tunnel Unsolicited Indication 


— з WLAN Transport 


Return Success/fFailure 


Sequence ШЕСІСІШ (8) 


NET. EVENT АМАМ TUNNEL 


Response data contains 
Request id as invalid 
entry. It contains the data 
and data length which 
needs to be forwarded to 
CM publishes tunnel indication the application. 

using notification manager and 
pass the data which in turn is 
passed to the registered 
applications. 


NET_EVENT_TUNNEL_IND 


MET EVENT TUNNEL IND 


Note: 
1) CM wil sendthe Indication using event delivery mechanism. CM will publish the Tunnel Indication 


and subscribed application vill receive notification for the same. So each application needs to register 
sath E vent Delivery module for receiving unsolicited tunnel indication from Data Networking. 
2)Request ID: А negative integer is considered as an invalid value for request ID. 


Figure 9.14: Tunnel Unsolicited Indication 
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9.2.1.15 Tunnel Unsolicited MT PDP Indication 


dco н РОР Transport 


Boot Up г 
Мер dplnit() 


Return Success/Failure 
MET EVENT РОР TLINNEL 


МЕТ EVENT TUNNEL IND 


CM publishes tunnel indication a el hectare ta 
using notification manager and Request id as invalid 


di entry. It containsthe data 
pass the data which inturn and data length which 


need to forwarded to 
application. 


passto the registered 
NET_EVENT_TUNNEL_IND applications. 


Application process the data 
and ind that this belong to MT 
PDP indication. So application 


will try to establish new data 
connection 


Rest of the procedure is 
same as other open 
connection request. 


Note: 
A Request ID : А negative integer is considered as an invalid 
маме for request ID. 


Figure 9.15: Tunnel Unsolicited MT PDP Indication 
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9.2.1.16 Usage of АРІ: NetCMGetTransportError 


Application Transport Plugin 


NetCMConnectionopen () 


NetWlanOpenConnecti on() 


Retum FAILURE 


Retum NET ERR, TRANSPORT 


If application wants to 
know the reason for error 


Note: Usage of API to get transport specific error 


Figure 9.16: Usage of API: NetCMGetTransportError 
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